Nové koncové body pro financování – změny oprávnění oproti Legacy

Nové Funding API Kraken zjednodušuje model oprávnění pro mnoho koncových bodů. Protože stejný API klíč funguje jak pro Legacy, tak pro nové koncové body, některé operace, které dříve vyžadovaly více oprávnění v Legacy, nyní vyžadují méně oprávnění. Tento článek vysvětluje, co se změnilo a na co byste si měli dát pozor.

Co se změnilo?

V Legacy Funding API vyžadovalo několik koncových bodů určených pouze pro čtení složená oprávnění. Například zobrazení adres pro výběr vyžadovalo, aby byl na stejném klíči povolen jak Query Funds, tak Withdraw Funds.

V nových koncových bodech jsou všechny koncové body pro financování určené pouze pro čtení sloučeny pod jediné oprávnění Query Funds. Nastavení klíčů pro monitorování a reporting je tak snazší, aniž byste museli udělovat zbytečná oprávnění k zápisu.

To však také znamená, že stávající API klíč s povoleným oprávněním Query Funds bude mít prostřednictvím nových koncových bodů přístup k více informacím, než umožňovaly legacy koncové body.

Koncové body se sníženými požadavky na oprávnění

Následující koncové body vyžadují méně oprávnění než jejich ekvivalenty v Legacy:

Nové koncové body	Nová oprávnění	Ekvivalent v Legacy	Oprávnění v Legacy
listFundingWithdrawals	Query Funds	Get Status of Recent Withdrawals	Withdraw Funds OR Data - Query Ledger Entries
listFundingAddresses	Query Funds	Get Withdrawal Addresses	Query Funds AND Withdraw Funds
getFundingAddresses	Query Funds	Get Withdrawal Addresses	Query Funds AND Withdraw Funds
listFundingMethods	Query Funds	Get Deposit Methods	Query Funds AND Deposit
listFundingWithdrawalLimits	Query Funds	Get Withdrawal Methods	Query Funds AND Withdraw

Co to znamená pro vaše stávající API klíče

Pokud máte API klíč vytvořený pouze s oprávněním Query Funds, může tento klíč nyní prostřednictvím nových koncových bodů přistupovat k následujícím informacím, které dříve přes Legacy přístupné nebyly:

Seznam adres pro výběr (dříve vyžadovalo také oprávnění Withdraw Funds)
Historie výběrů (dříve vyžadovalo oprávnění Withdraw Funds nebo Data - Query Ledger Entries)
Dostupné způsoby financování (dříve vyžadovalo také oprávnění Deposit)
Limity a způsoby výběru (dříve vyžadovalo také oprávnění Deposit)

Proč na tom záleží

Pokud jste klíč s oprávněním pouze Query Funds poskytli třetí straně pro sledování portfolia nebo reportování, může tato služba prostřednictvím nového API získat další informace o účtu, včetně vašich adres pro výběr a historie výběrů. Tato data jsou sice jen ke čtení, ale může jít o větší přístup, než jste původně zamýšleli.

Koncové body s nezměněnými oprávněními

Následující nové koncové body vyžadují stejná oprávnění jako jejich ekvivalenty v Legacy:

Koncový bod	Oprávnění	Operace
createFundingWithdrawal	Withdraw Funds	Provedení výběru na adresu na seznamu povolených
listFundingDepositLimits	Query Funds	Zobrazení limitů vkladů
listFundingDeposits	Query Funds	Seznam vkladů
listFundingAssets	Query Funds	Seznam dostupných aktiv pro financování
listFundingNetworks	Query Funds	Seznam dostupných sítí pro financování
calculateFundingFees	Query Funds	Výpočet poplatků za vklad/výběr

Nové koncové body a jejich oprávnění

Následující koncové body jsou nové a nemají ekvivalent v Legacy:

Koncový bod	Oprávnění	Operace
claimFundingDepositAddress	Vložit	Vygenerování nebo nárokování adresy vkladu
generateFundingLightningAddress	Vložit	Vygenerování Lightning adresy/faktury pro vklad
listFundingClaimedAddresses	Query Funds	Seznam adres vkladu
createFundingAddress	Add Withdrawal Addresses	Vytvoření adresy pro výběr
deleteFundingAddress	Add Withdrawal Addresses	Odstranění adresy pro výběr

Doporučení

Zkontrolujte stávající API klíče

Pokud máte API klíče s povoleným oprávněním Query Funds sdílené se službami třetích stran, zkontrolujte, zda vám vyhovuje, že tyto služby získají přístup k dalším datům (pouze pro čtení) prostřednictvím nových koncových bodů.

Dodržujte princip nejmenšího oprávnění

Při vytváření nových API klíčů povolujte pouze oprávnění, která vaše aplikace skutečně potřebuje. Zjednodušený model oprávnění usnadňuje udělení přístupu jen pro čtení bez nutnosti zároveň povolovat přístup pro zápis.

Používejte další bezpečnostní opatření

U každého API klíče, zejména těch s rozšířenými oprávněními, zvažte aktivaci těchto funkcí:

Dvoufaktorové ověření (2FA) pro API klíče – vyžaduje zadání kódu 2FA při každém volání API