Määritä laajuudet ennen luontia
Anna avaimelle vain ne toiminnot ja resurssit, joita sen tehtävä vaatii. Valvontaintegraatio voi tarvita lukuoikeuden; käyttöönottotyökalu voi tarvita määritellyn joukon elinkaaritoimintoja. Pidä laskutusvaltuudet erillään, kun mahdollista.
Paljasta huolellisesti ja säilytä yksityisesti
Oikea avain tulee näyttää turvallisen luontiprosessin kautta, suojata levossa ja sulkea pois URL-tiedostoista, selainpaketeista ja lähdekoodin hallinnasta. Kirjaa omistaja, käyttötarkoitus ja luontiaika paljastamatta itse salaisuutta.
Tee peruuttamisesta käytännöllistä
Myönnä erilliset tunnistetiedot jokaiselle integraatiolle, jotta yksi voidaan peruuttaa pysäyttämättä kaikkea. Kierrätä harkitusti ja varmista, että vanha avain ei enää toimi. Tutki odottamatonta käyttöä rajatuilla auditointitietueilla.
Testaa rajat
Hyödyllinen käyttöönottotesti sisältää sallitun toiminnon, kielletyn toiminnon, vanhentuneen tai peruutetun avaimen ja pyynnön avaimen resurssirajan ulkopuolelta. Pelkkä todennus ei ole valtuutus.
Ehdokasavaimen käytäntö
API-sopimus kuvaa enintään kymmenen aktiivista avainta tiliä kohden, nimetyin käyttötarkoituksin, valinnaisin vanhenemisin ja lähdeosoiterajoituksin. Käyttöalueet erottavat lukemisen, palvelinhallinnan, laskutuksen ja täyden hallinnan. Luontiprosessin tulee näyttää salaisuus kerran ja säilyttää vain asianmukaisesti suojattu vahvistusesitys.
Auditoi paljastamatta pyyntöä
Hyödyllinen auditointitietue voi sisältää avaintunnisteen, reitin, ajan ja lopputuloksen säilyttämättä salasanoja tai kokonaisia pyyntöjen runkoja. Myös tietueen käyttöoikeus vaatii suojausta. Määrittele säilytys ja vienti sen sijaan, että säilyttäisit arkaluontoista toimintahistoriaa toistaiseksi.
Anna jokaiselle automaatiolle oma tunnistetietonsa
Varmuuskopioiden tarkistajan, käyttöönoton työntekijän ja laskutusintegraation ei tulisi jakaa samaa täyden käyttöoikeuden avainta. Nimeä avain tehtävänsä mukaan, myönnä pienin käyttöoikeus ja kirjaa, kuka sen omistaa. Aiottuja ryhmiä ovat read, servers, billing ja full; niiden tarkka toimintayhdistäminen on testattava, kun API tulee saataville.
Luonti, tallennus ja vaihto
Ehdotettu tilimalli sallii enintään kymmenen aktiivista avainta. Näytä uusi salaisuus kerran ja säilytä sen jälkeen vain palvelinpuolen vahvistin, joka tarvitaan sen todentamiseen. Tallenna asiakaskopio salaisuuksien hallintaan tai suojattuun palveluympäristöön. Vaihda ottamalla käyttöön korvaava avain, tarkistamalla riippuvainen työntekijä ja peruuttamalla sitten vanha avain; älä koskaan sijoita avainta julkiseen URL- tai selainpakettiin.
Peru oikeudet, älä todisteita
Avaimen poistaminen käytöstä estää tulevat pyynnöt säilyttäen samalla rajatun turvallisuustietueen sen aiemmasta käytöstä. Jos tunnistetieto on saattanut vuotaa, peruuta se viipymättä, tutki vaikutuksen alaiset resurssit ja vaihda siihen liittyvät salaisuudet. Avainluettelon tulee näyttää turvallinen tunniste ja viimeisen käytön metatiedot eikä palautettavia salaisuuksia selkokielisenä.
Hieman lisää selkeyttä.
Voiko tämä sivu luoda toimivan API -avaimen?
Ei. Avaimen luonti vaatii todennetun tilitaustajärjestelmän; tämä tietosivu ei myönnä tunnisteita.