La nuova API di finanziamento di Kraken semplifica il modello di autorizzazione per molti endpoint. Poiché la stessa API key funziona sia con Legacy che con i nuovi endpoint, alcune operazioni che in precedenza richiedevano più autorizzazioni in Legacy ora richiedono meno autorizzazioni nei nuovi endpoint. Questo articolo spiega cosa è cambiato e di cosa dovresti essere a conoscenza.
Nella Legacy Funding API, diversi endpoint di sola lettura richiedevano autorizzazioni composte. Ad esempio, la visualizzazione dei tuoi indirizzi di prelievo richiedeva che sia Query Funds che Withdraw Funds fossero abilitati sulla stessa chiave.
Nei nuovi endpoint, tutti gli endpoint di finanziamento di sola lettura sono stati consolidati sotto un'unica autorizzazione Query Funds. Questo rende più semplice impostare le chiavi per il monitoraggio e la reportistica senza concedere un accesso in scrittura non necessario.
Tuttavia, ciò significa anche che una API key esistente con Query Funds abilitato potrà accedere a più informazioni tramite i nuovi endpoint rispetto a quanto poteva fare tramite gli endpoint Legacy.
I seguenti endpoint richiedono meno autorizzazioni rispetto ai loro equivalenti Legacy:
Nuovi endpoint | Nuove autorizzazioni | Equivalente Legacy | Autorizzazioni Legacy |
|---|---|---|---|
| listFundingWithdrawals | Query Funds | Ottieni stato dei prelievi recenti | Withdraw Funds OR Data - Query Ledger Entries |
| listFundingAddresses | Query Funds | Ottieni indirizzi di prelievo | Query Funds AND Withdraw Funds |
| getFundingAddresses | Query Funds | Ottieni indirizzi di prelievo | Query Funds AND Withdraw Funds |
| listFundingMethods | Query Funds | Ottieni metodi di deposito | Query Funds E Deposit |
| listFundingWithdrawalLimits | Query Funds | Ottieni Metodi di prelievo | Query Funds E Withdraw |
Se hai una chiave API che è stata creata con la sola autorizzazione Query Funds, quella chiave può ora accedere alle seguenti informazioni tramite i nuovi endpoint a cui in precedenza non poteva accedere tramite Legacy:
Il tuo elenco di indirizzi di prelievo (in precedenza richiedeva anche Withdraw Funds)
La tua cronologia di prelievi (in precedenza richiedeva Withdraw Funds o Data - Query Ledger Entries)
Metodi di finanziamento disponibili (in precedenza richiedeva anche Deposit)
Limiti e metodi di prelievo (in precedenza richiedeva anche Deposit)
Se hai concesso una chiave solo Query Funds a un servizio di terze parti per il monitoraggio del portafoglio o la reportistica, tale servizio può ora recuperare ulteriori informazioni sull'account tramite la nuova API, inclusi i tuoi indirizzi di prelievo e la cronologia dei prelievi. Sebbene questi dati siano in sola lettura, ciò potrebbe comportare una visibilità maggiore di quanto intendessi condividere.
I seguenti nuovi endpoint richiedono le stesse autorizzazioni dei loro equivalenti Legacy:
Endpoint | Autorizzazione | Operazione |
|---|---|---|
| createFundingWithdrawal | Prelievo Fondi | Crea un prelievo a un indirizzo in whitelist |
| listFundingDepositLimits | Query Funds | Visualizza limiti di deposito |
| listFundingDeposits | Query Funds | Elenca depositi |
| listFundingAssets | Query Funds | Elenca gli asset di finanziamento disponibili |
| listFundingNetworks | Query Funds | Elenca le reti di finanziamento disponibili |
| calculateFundingFees | Query Funds | Calcola le commissioni di deposito/prelievo |
I seguenti endpoint sono nuovi e non hanno equivalenti Legacy:
Endpoint | Autorizzazione | Operazione |
|---|---|---|
| claimFundingDepositAddress | Deposito | Genera o richiedi un indirizzo di deposito |
| generateFundingLightningAddress | Deposito | Genera un indirizzo/fattura di deposito Lightning |
| listFundingClaimedAddresses | Query Funds | Elenca gli indirizzi di deposito |
| createFundingAddress | Aggiungi indirizzi di prelievo | Crea un indirizzo di prelievo |
| deleteFundingAddress | Aggiungi indirizzi di prelievo | Elimina un indirizzo di prelievo |
Controlla le tue API key esistenti
Se hai API key con Query Funds abilitate e condivise con servizi di terze parti, valuta se ti senti a tuo agio con tali servizi che accedono a dati aggiuntivi di sola lettura tramite i nuovi endpoint.
Applica il principio del privilegio minimo
Quando crei nuove API key, abilita solo le autorizzazioni di cui la tua applicazione ha bisogno. Il modello di autorizzazione semplificato facilita la concessione dell'accesso in sola lettura senza concedere anche l'accesso in scrittura.
Utilizza controlli di sicurezza aggiuntivi
Per qualsiasi API key, specialmente quelle con autorizzazioni elevate, considera di abilitare:
Autenticazione a due fattori (2FA) per le API key per richiedere un codice 2FA ad ogni chiamata API