Nowe endpointy finansowania — Zmiany uprawnień z wersji Legacy

Nowe API finansowania Krakena upraszcza model uprawnień dla wielu endpointów. Ponieważ ten sam klucz API działa zarówno w wersji Legacy, jak i w nowych endpointach, niektóre operacje, które wcześniej wymagały wielu uprawnień w wersji Legacy, teraz wymagają mniej uprawnień w nowych endpointach. Ten artykuł wyjaśnia, co się zmieniło i o czym powinieneś wiedzieć.

Co się zmieniło?

W Legacy Funding API kilka endpointów tylko do odczytu wymagało złożonych uprawnień. Na przykład, aby wyświetlić swoje adresy wypłat, wymagane było włączenie zarówno Query Funds, jak i Withdraw Funds na tym samym kluczu.

W nowych endpointach wszystkie endpointy finansowania tylko do odczytu zostały skonsolidowane pod jednym uprawnieniem Query Funds. Ułatwia to konfigurowanie kluczy do monitorowania i raportowania bez udzielania niepotrzebnego dostępu do zapisu.

Jednak oznacza to również, że istniejący klucz API z włączonym Query Funds będzie mógł uzyskać dostęp do większej ilości informacji za pośrednictwem nowych endpointów niż za pośrednictwem endpointów Legacy.

Endpointy ze zmniejszonymi wymaganiami dotyczącymi uprawnień

Następujące endpointy wymagają mniej uprawnień niż ich odpowiedniki w wersji Legacy:

Nowe endpointy	Nowe uprawnienia	Odpowiednik Legacy	Uprawnienia Legacy
listFundingWithdrawals	Zapytanie o środki	Uzyskaj status ostatnich wypłat	Withdraw Funds LUB Data - Query Ledger Entries
listFundingAddresses	Zapytanie o środki	Uzyskaj adresy wypłat	Query Funds I Withdraw Funds
getFundingAddresses	Zapytanie o środki	Uzyskaj adresy wypłat	Query Funds I Withdraw Funds
listFundingMethods	Zapytanie o środki	Uzyskaj metody wpłat	Zapytaj o środki I Wpłata
listFundingWithdrawalLimits	Zapytanie o środki	Pobierz metody wypłat	Zapytaj o środki I Wypłata

Co to oznacza dla Twoich istniejących kluczy API

Jeśli posiadasz klucz API, który został utworzony wyłącznie z uprawnieniami Zapytaj o środki, ten klucz może teraz uzyskać dostęp do następujących informacji za pośrednictwem nowych punktów końcowych, do których wcześniej nie miał dostępu poprzez starsze rozwiązania:

Twoją listę adresów wypłat (wcześniej wymagało również Wypłaty środków)
Twoją historię wypłat (wcześniej wymagało Wypłaty środków lub Data - Zapytania o wpisy w księdze)
Dostępne metody finansowania (wcześniej wymagało również Wpłaty)
Limity i metody wypłat (wcześniej wymagało również Wpłaty)

Dlaczego to ma znaczenie

Jeśli udzieliłeś kluczowi wyłącznie z uprawnieniami Zapytaj o środki usłudze zewnętrznej do śledzenia portfela lub raportowania, ta usługa może teraz pobrać dodatkowe informacje o koncie za pośrednictwem nowego API, w tym Twoje adresy wypłat i historię wypłat. Chociaż te dane są tylko do odczytu, może to oznaczać większą widoczność, niż zamierzałeś udostępnić.

Punkty końcowe z niezmienionymi uprawnieniami

Następujące nowe punkty końcowe wymagają tych samych uprawnień co ich starsze odpowiedniki:

Punkt końcowy	Uprawnienie	Operacja
createFundingWithdrawal	Wypłać środki	Utwórz wypłatę na adres z białej listy
listFundingDepositLimits	Zapytanie o środki	Wyświetl limity wpłat
listFundingDeposits	Zapytanie o środki	Wyświetl wpłaty
listFundingAssets	Zapytanie o środki	Wypisz dostępne aktywa do zasilenia
listFundingNetworks	Zapytanie o środki	Wypisz dostępne sieci do zasilenia
calculateFundingFees	Zapytanie o środki	Oblicz opłaty za wpłatę/wypłatę

Nowe punkty końcowe i ich uprawnienia

Poniższe punkty końcowe są nowe i nie mają odpowiednika w starszej wersji:

Punkt końcowy	Uprawnienie	Operacja
claimFundingDepositAddress	Wpłata	Wygeneruj lub odbierz adres wpłaty
generateFundingLightningAddress	Wpłata	Wygeneruj adres wpłaty/fakturę Lightning
listFundingClaimedAddresses	Zapytanie o środki	Wypisz adresy wpłat
createFundingAddress	Dodaj adresy wypłat	Utwórz adres wypłaty
deleteFundingAddress	Dodaj adresy wypłat	Usuwanie adresu wypłaty

Zalecenia

Przejrzyj istniejące klucze API

Jeśli masz klucze API z włączoną opcją Query Funds, które są udostępniane usługom stron trzecich, sprawdź, czy zgadzasz się, aby te usługi uzyskiwały dostęp do dodatkowych danych tylko do odczytu za pośrednictwem nowych punktów końcowych.

Zastosuj zasadę najmniejszych uprawnień

Podczas tworzenia nowych kluczy API włączaj tylko te uprawnienia, których potrzebuje Twoja aplikacja. Uproszczony model uprawnień ułatwia przyznawanie dostępu tylko do odczytu bez jednoczesnego przyznawania dostępu do zapisu.

Użyj dodatkowych kontroli bezpieczeństwa

Dla każdego klucza API, zwłaszcza tych z podwyższonymi uprawnieniami, rozważ włączenie:

Uwierzytelniania dwuskładnikowego (2FA) dla kluczy API, aby wymagać kodu 2FA przy każdym wywołaniu API