Il nuovo Funding API di Kraken semplifica il modello dei permessi per molti endpoint. Poiché la stessa chiave API funziona sia con il Legacy che con i nuovi endpoint, alcune operazioni che in precedenza richiedevano più permessi nel Legacy ora ne richiedono di meno nei nuovi endpoint. Questo articolo spiega cosa è cambiato e cosa è opportuno sapere.
Nel Legacy Funding API, diversi endpoint di sola lettura richiedevano permessi composti. Ad esempio, per visualizzare i tuoi indirizzi di prelievo era necessario abilitare sia Query Funds che Withdraw Funds sulla stessa chiave.
Nei nuovi endpoint, tutti gli endpoint di versamento di sola lettura sono stati consolidati sotto un unico permesso Query Funds. In questo modo è più semplice configurare le chiavi per il monitoraggio e la reportistica senza concedere accessi in scrittura non necessari.
Tuttavia, ciò significa anche che una chiave API esistente con Query Funds abilitato potrà accedere a più informazioni tramite i nuovi endpoint di quante ne potesse accedere tramite quelli legacy.
I seguenti endpoint richiedono meno permessi rispetto ai corrispondenti Legacy:
Nuovi endpoint | Nuovi permessi | Equivalente Legacy | Permessi 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 |
Se hai una chiave API creata con il solo permesso Query Funds, quella chiave può ora accedere alle seguenti informazioni tramite i nuovi endpoint, che in precedenza non erano accessibili tramite Legacy:
L'elenco dei tuoi indirizzi di prelievo (in precedenza richiedeva anche Withdraw Funds)
Lo storico dei tuoi prelievi (in precedenza richiedeva Withdraw Funds o Data - Query Ledger Entries)
I metodi di versamento disponibili (in precedenza richiedeva anche Deposit)
Limiti e metodi di prelievo (in precedenza richiedeva anche Deposit)
Se hai concesso una chiave con il solo permesso Query Funds a un servizio di terze parti per il monitoraggio del portfolio o la reportistica, quel servizio può ora recuperare ulteriori informazioni sull'account tramite la nuova API, inclusi i tuoi indirizzi di prelievo e lo storico dei prelievi. Poiché questi dati sono in sola lettura, potresti aver condiviso più informazioni di quanto intendessi.
I seguenti nuovi endpoint richiedono gli stessi permessi dei rispettivi equivalenti Legacy:
Endpoint | Permesso | Operazione |
|---|---|---|
| createFundingWithdrawal | Prelievo Fondi | Crea un prelievo verso un indirizzo autorizzato |
| listFundingDepositLimits | Query Funds | Visualizza i limiti di deposito |
| listFundingDeposits | Query Funds | Elenca i depositi |
| listFundingAssets | Query Funds | Elenca gli asset di versamento disponibili |
| listFundingNetworks | Query Funds | Elenca i network di versamento disponibili |
| calculateFundingFees | Query Funds | Calcola le commissioni di deposito/prelievo |
I seguenti endpoint sono nuovi e non hanno un equivalente Legacy:
Endpoint | Permesso | Operazione |
|---|---|---|
| claimFundingDepositAddress | Deposito | Genera o riscatta 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 |
Verifica le tue chiavi API esistenti
Se hai chiavi API con Query Funds abilitato condivise con servizi di terze parti, valuta se desideri che questi servizi accedano a ulteriori dati in sola lettura tramite i nuovi endpoint.
Applica il principio del privilegio minimo
Quando crei nuove chiavi API, abilita solo le autorizzazioni necessarie alla tua applicazione. Il modello di autorizzazioni semplificato rende più semplice concedere l'accesso in sola lettura senza dover concedere anche l'accesso in scrittura.
Utilizza controlli di sicurezza aggiuntivi
Per qualsiasi chiave API, in particolare quelle con autorizzazioni elevate, valuta di abilitare:
Autenticazione a due fattori (2FA) per le chiavi API per richiedere un codice 2FA a ogni chiamata API