API-nycklar för telefoni – behörigheter, förvaring och rotation

Ge varje integration rätt omfattning

Kartlägg vilka resurser och åtgärder integrationen faktiskt behöver. Börja med så begränsad åtkomst som leverantörens behörighetsmodell tillåter. Dokumentera vilken organisation och miljö nyckeln tillhör.

Separata integrationer bör kunna förvaltas och stängas av utan att onödigt påverka varandra. Kontrollera dock vilka möjligheter till separata nycklar och rättigheter som finns för det aktuella kontot.

Låt nyckeln stanna på servern

Webbläsaren ska anropa er egen server med användarens session. Servern kontrollerar behörigheten och hämtar API-hemligheten från avsedd hemlighetshantering. Lägg inte långlivade leverantörsnycklar i frontendkod, publika byggfiler eller exempel som kopieras till kunder.

Miljökonfiguration behöver också skyddas. En miljövariabel gör inte hemligheten säker om den skrivs ut i en fellogg eller hamnar i en exporterad felsökningsrapport. Maskera hemligheter i loggar och supportunderlag.

Öva ett nyckelbyte innan det blir bråttom

Beskriv hur en ny nyckel skapas, distribueras och verifieras och hur den gamla återkallas. Om parallella nycklar stöds kan ni kontrollera den nya innan bytet slutförs. Om de inte stöds behöver bytet planeras efter den faktiska begränsningen.

Verifiera en tillåten läsning efter bytet och kontrollera att integrationen använder den nya hemligheten. Återkalla sedan den gamla enligt rutinen och kontrollera att den inte längre fungerar. Spara referenser och tidpunkter, inte nyckelvärden, i ändringshistoriken.

Ha en rutin för misstänkt exponering

När en hemlighet kan ha läckt behöver ansvarig kunna återkalla den, ersätta den och bedöma vilka åtgärder som kan ha gjorts med den. Att bara ta bort värdet från senaste kodversionen är inte samma sak som att göra nyckeln obrukbar.

Kontrollera beroenden så att samma nyckel inte ligger kvar i en gammal serverprocess eller ett schemalagt jobb. Förvara kontaktvägar och instruktioner där driftansvariga kan nå dem även när integrationen är nere.

Kontrollera felvägen

Testa en återkallad nyckel i en isolerad miljö. Användaren ska få ett begripligt tillgänglighetsfel, medan supporten kan se vilken integration som behöver åtgärdas. Hemligheten får aldrig ingå i det synliga felmeddelandet.