Nye finansieringsslutpunkter – tilladelsesændringer fra Legacy

Krakens nye Funding API forenkler tilladelsesmodellen for mange slutpunkter. Da den samme API-nøgle fungerer på tværs af både Legacy og de nye slutpunkter, kræver visse handlinger, der tidligere krævede flere tilladelser i Legacy, nu færre tilladelser i de nye slutpunkter. Denne artikel forklarer, hvad der er ændret, og hvad du bør være opmærksom på.

Hvad er ændret?

I Legacy Funding API krævede flere skrivebeskyttede slutpunkter sammensatte tilladelser. For eksempel krævede visning af dine udbetalingsadresser, at både Query Funds og Withdraw Funds var aktiveret på den samme nøgle.

I de nye slutpunkter er alle skrivebeskyttede finansieringsslutpunkter samlet under én Query Funds-tilladelse. Det gør det nemmere at oprette nøgler til overvågning og rapportering uden at tildele unødvendig skriveadgang.

Det betyder dog også, at en eksisterende API-nøgle med Query Funds aktiveret vil kunne tilgå flere oplysninger via de nye slutpunkter, end den kunne via legacy-slutpunkterne.

Slutpunkter med reducerede tilladelseskrav

Følgende slutpunkter kræver færre tilladelser end deres Legacy-modstykker:

Nye slutpunkter	Nye tilladelser	Legacy-modstykke	Legacy-tilladelser
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 OG Deposit
listFundingWithdrawalLimits	Query Funds	Get Withdrawal Methods	Query Funds OG Withdraw

Hvad betyder det for dine eksisterende API-nøgler

Hvis du har en API-nøgle, der kun er oprettet med tilladelsen Query Funds, kan denne nøgle nu tilgå følgende oplysninger via de nye slutpunkter, som den tidligere ikke kunne tilgå via Legacy:

Din liste over udbetalingsadresser (krævede tidligere også Withdraw Funds)
Din udbetalingshistorik (krævede tidligere Withdraw Funds eller Data - Query Ledger Entries)
Tilgængelige finansieringsmetoder (krævede tidligere også Deposit)
Udbetalingsgrænser og -metoder (krævede tidligere også Deposit)

Derfor er det vigtigt

Hvis du har givet en tredjepartstjeneste en nøgle med kun Query Funds-tilladelse til porteføljesporing eller rapportering, kan denne tjeneste nu hente yderligere kontooplysninger via den nye API, herunder dine udbetalingsadresser og udbetalingshistorik. Selvom disse data er skrivebeskyttede, kan du have givet adgang til mere, end du havde til hensigt.

Slutpunkter med uændrede tilladelser

Følgende nye slutpunkter kræver de samme tilladelser som deres Legacy-modstykker:

Slutpunkt	Tilladelse	Handling
createFundingWithdrawal	Withdraw Funds	Opret en udbetaling til en hvidlistet adresse
listFundingDepositLimits	Query Funds	Vis indbetalingsgrænser
listFundingDeposits	Query Funds	Vis indbetalinger
listFundingAssets	Query Funds	Vis tilgængelige finansieringsaktiver
listFundingNetworks	Query Funds	Vis tilgængelige finansieringsnetværk
calculateFundingFees	Query Funds	Beregn gebyrer for ind- og udbetalinger

Nye slutpunkter og deres tilladelser

Følgende slutpunkter er nye og har ingen Legacy-ækvivalent:

Slutpunkt	Tilladelse	Handling
claimFundingDepositAddress	Indbetal	Generer eller anmod om en indbetalingsadresse
generateFundingLightningAddress	Indbetal	Generer en Lightning-indbetalingsadresse/faktura
listFundingClaimedAddresses	Query Funds	Vis indbetalingsadresser
createFundingAddress	Tilføj udbetalingsadresser	Opret en udbetalingsadresse
deleteFundingAddress	Tilføj udbetalingsadresser	Slet en udbetalingsadresse

Anbefalinger

Gennemgå dine eksisterende API-nøgler

Hvis du har API-nøgler med Query Funds aktiveret, som er delt med tredjepartstjenester, bør du vurdere, om du er tryg ved, at disse tjenester kan tilgå yderligere skrivebeskyttede data via de nye slutpunkter.

Anvend princippet om mindste privilegium

Aktivér kun de tilladelser, din applikation har brug for, når du opretter nye API-nøgler. Den forenklede tilladelsesmodel gør det nemmere at give skrivebeskyttet adgang uden samtidig at give skriveadgang.

Brug yderligere sikkerhedsforanstaltninger

For alle API-nøgler – særligt dem med forhøjede tilladelser – bør du overveje at aktivere:

Totrinsgodkendelse (2FA) til API-nøgler for at kræve en 2FA-kode ved hvert API-kald