API-nøgler

API-nøgler er ikke Medlemmer med legitimationsoplysninger. De har deres egen, enklere tilladelsesmodel:

De to modeller er bevidst holdt adskilt. Medlemmer tildeles roller, profiler og kontospecifikke tilladelser, fordi mennesker påtager sig mange forskelligartede ansvarsområder. Nøgler bruger en flad model med ét sæt tilladelser på tværs af konti, fordi automatisering bør være snævert afgrænset, ensartet og nem at gennemse.

En API-nøgle kombinerer to valg: hvad den må gøre (dens tilladelser) og hvor (dens konti).

Tilladelser

Kontotilknytning

Hver nøgle er tilknyttet én eller flere konti, valgt ved oprettelsen og mulig at redigere efterfølgende. Nøglens tilladelser gælder ensartet for alle valgte konti:

• En nøgle med Query funds og Create and modify orders på to valgte konti kan aflæse saldi og handle på begge – og intet andet.
• Der er ingen variation pr. konto inden for en nøgle. Hvis din automatisering skal handle på én konto, men kun læse en anden, skal du bruge to nøgler. Det holder konsekvenserne af hver nøgle overskuelige.

Vælg en specifik konto efter behov

Private API-anmodninger bruger organisationens primære konto, når account_id udelades:

Angiv account_id som query-parameter i URL'en for at arbejde på en specifik konto:

Angiv den i URL'en, ikke i request body. En eksplicit account_id tilsidesætter fallback til primærkontoen. Den udvider ikke nøglens kontotilknytning eller tilladelser. Kan nøglen ikke operere på den valgte konto, afvises anmodningen.

FIX-forbindelse

Nøgler med ordretilladelser understøtter FIX-forbindelse til spothandel sammen med REST- og WebSocket-API'erne. En FIX-session har de samme tilladelser og kontotilknytning som den nøgle, der ligger bag den: den handler kun på nøglens valgte konti og inden for nøglens tilladelser. Virksomheder, der kører FIX-ordreflow, dedikerer typisk én nøgle pr. session, afgrænset til de konti, som desken handler på.

Sikkerhedsindstillinger

Organisationens ledelse gælder for både, hvad nøgler kan gøre, og hvordan de administreres.

Hvad nøgler gør

Tokategorireglen for medlemmer gælder tilsvarende for nøgler:

• Direkte handlinger udføres øjeblikkeligt. Handel, Earn, saldoforespørgsler, hovedbogsforespørgsler og dataeksport gennemføres med det samme, inden for nøglens tilladelser og konti.
• Styrede handlinger opretter anmodninger. En udbetaling eller adresseændring, der igangsættes af en nøgle, følger samme forløb som én igangsat af et medlem: arbejdsgangens politik afgør, om den gennemføres øjeblikkeligt, eller om den afventer i godkendelseskøen.

En nøgle kan kun igangsætte styrede anmodninger. Nøgler kan aldrig godkende – funktionsadskillelse kræver et menneskeligt medlem til enhver godkendelse, og et script kan ikke erstatte dette skøn. Kræver politikken for udbetalingsanmodninger to godkendelser, afventer en nøgleiniteret udbetaling to medlemmer – præcis som en medlemsiniteret ville.

Et vellykket kald er ikke en gennemført udbetaling

Byg din automatisering ud fra denne asynkronitet. WithdrawFunds returnerer approval_request_id sammen med refid:

• refid bekræfter, at anmodningen findes – ikke at midlerne er overført. Beløbet låses på kildekontoens ved indsendelse og afregnes først, når anmodningen er godkendt. Se Midler låses ved indsendelse.
• approval_request_id er referencen for den godkendelse, som udbetalingen afventer. Gem den sammen med din egen registrering af udbetalingen.
• Udbetalinger, der afventer godkendelse, vises ikke i WithdrawStatus. En anmodning, der afvises eller udløber, opretter slet ingen udbetalingspost, så fravær fra WithdrawStatus betyder aldrig, at en udbetaling ikke blev indsendt.

Automatisering, der behandler et refid som bevis på gennemførelse, vil rapportere udbetalinger som afregnet, mens de sidder i godkendelseskøen – og afstemning, der konkluderer "ikke i WithdrawStatus, altså aldrig indsendt", vil være forkert for både afventende og afviste anmodninger.

Nøgler har heller ingen adgang til de administrative arbejdsgange. Styring af teamadgang, API-nøgler, konti, adresser (ud over at starte adresseanmodninger) og politikker er forbeholdt medlemmer.

Sådan administreres nøgler

Oprettelse, redigering og tilbagekaldelse af API-nøgler er en styret handling under den dedikerede Manage API Keys-arbejdsgang, adskilt fra Manage Team & Access. Adskillelsen har to fordele:

• Forskellige administratorer. Du kan lade en driftsingeniør administrere nøgler uden mulighed for at ændre medlemmers adgang – og omvendt.
• Forskellige politikker. Nøglestyring kan have sine egne godkendelseskrav. Mange organisationer kræver uafhængig godkendelse for at oprette eller ændre en nøgle – en ny legitimationsoplysning er en ny adgangsvej til dine konti – mens tilbagekaldelse holdes hurtig.

1. Gå til API-nøgler og vælg Opret nøgle.
2. Giv nøglen et navn, der afspejler dens formål – det system den betjener og hvad den gør – så dens funktion er tydelig ved gennemgang og sikkerhedshændelser.
3. Vælg nøglens tilladelser.
4. Vælg de konti, nøglen skal gælde for. Tilladelserne gælder ensartet for alle valgte konti.
5. Konfigurer sikkerhedsindstillinger: udløbsdato, IP-begrænsninger, nonce-vindue.
6. Gennemse og bekræft. Hvis politikken for administration af API-nøgler kræver godkendelse, afventer anmodningen de nødvendige godkendelser, før nøglen udstedes.

Redigering af en nøgles tilladelser eller konti og tilbagekaldelse af en nøgle følger den samme styrede proces.

Kaldet oprettede en udbetalingsanmodning, og politikken for udbetalingsanmodninger tilbageholder den, indtil den er godkendt. Tjek siden Anmodninger – anmodningen vises der med nøglen som initiativtager og afventer de påkrævede medlemsgodkendelser. Det er ledelsesmodellen, der fungerer efter hensigten: automatisering foreslår, mennesker godkender.

Beløbet er reserveret på kildekontoen, mens anmodningen afventer, og er derfor allerede sat til side til udbetalingen. Spor anmodningen ved hjælp af approval_request_id, der returneres med kaldet.

Den berørte konto er ikke en del af nøglens kontotilknytning. En nøgle virker kun på de valgte konti. Rediger nøglen for at tilføje kontoen – bemærk, at nøglens fulde tilladelser gælder der, da nøgler ikke har kontosspecifikke tilladelser. Hvis det er for bredt, kan du oprette en anden nøgle afgrænset til den nye konto.

En enkelt nøgle kan ikke give forskellige tilladelser pr. konto. Opret to nøgler: en handelsnøgle tilknyttet konto A og en skrivebeskyttet nøgle tilknyttet konto B. Nøgler med et snævrere scope er også nemmere at gennemgå og sikrere at tilbagekalde.

Arbejdsgangen til administration af API-nøgler kræver sandsynligvis godkendelse, og anmodningen afventer stadig. Nøglen udstedes og dens hemmelige kode vises først, når de nødvendige godkendelser er indsamlet. Tjek anmodningens status på siden Anmodninger.

Nej. Godkendelse kræver altid en person. Dette er en systemregel, ikke en konfigurerbar politik – det er den, der giver flerpartsgodkendelse mening, når automatisering igangsætter pengeoverførsler.