Správná péče o klíče API
Plný a vlastní přístup, odvolání a nahrazení klíče a jak poznat klíč, který nikdo nepoužívá.
Klíč API jedná jménem vašeho účtu i bez vás: odkudkoli, dokud ho neodvoláte. Stránka Ověřování popisuje, jak se klíč vytváří a posílá při volání. Tato stránka je o tom, jak mít klíče, které už máte, v pořádku.
Dejte klíči jen to, co potřebuje
Každý klíč má Plný přístup nebo Vlastní přístup. Volí se při vytvoření a později jde změnit ve stejném formuláři.
- Plný přístup dosáhne na každou metodu, kterou váš účet může volat, včetně těch, které přibyly po vytvoření klíče. Nic, co je označené jako soukromé, se nezahrnuje nikdy, ať má klíč jakýkoli režim přístupu.
- Vlastní přístup dosáhne jen na metody, které jste výslovně zaškrtli, seskupené podle mikroslužby, s parametry každé metody vedle ní. Metoda, která přibude později, není pokryta, dokud se nevrátíte a nezaškrtnete ji.
Klíč zapojený do skriptu, úlohy CI nebo serveru potřebuje jen těch pár metod, které daná úloha skutečně volá. Vlastní přístup zajistí, že uniklý klíč nemůže dělat víc než práci, pro kterou vznikl.
Vytvoření, zobrazení a zkopírování
K vytvoření klíče musí být váš účet ověřen na úrovni 2, viz Ověření. Tlačítko Vytvořit klíč to vysvětlí a pokud tam ještě nejste, odkáže vás rovnou na další nedokončený krok. Hodnota nově vytvořeného klíče se zobrazí jednou v panelu Quick copy nahoře v seznamu. Potom ji každý řádek drží skrytou a vlastní tlačítko řádku pro zobrazení ji ukáže znovu na 20 sekund, než se sama opět skryje.
Hodnota se nikdy nezapisuje do logu, do oznámení ani do adresního řádku, jen do vaší schránky. Zacházejte s ní stejně jako s heslem. Kdo ji má, může jednat jako váš účet.
Nahrazení, odvolání a odhalení nepoužívaného klíče
Samostatná akce rotace neexistuje, protože hodnota klíče je jeho vlastní identifikátor. Nahradit vytvoří nový klíč se stejným názvem a přístupem, starý odvolá a novou hodnotu zobrazí jednou, abyste ji mohli zkopírovat před zavřením dialogu. Odvolat klíč odstraní úplně a nejdřív vás požádá o potvrzení jeho názvem, protože to nejde vrátit zpět.
Řádek každého klíče ukazuje, kdy byl naposledy použit, z aktivity za posledních 7 dní. Klíč bez řádku pod sebou v tomto období neprovedl žádné volání. Právě na takový řádek se vyplatí podívat znovu.
Nahraďte klíč, který mohl uniknout
Otevřete klíč, stiskněte Nahradit a novou hodnotu zkopírujte ihned, jak se objeví. Stará hodnota přestane fungovat v okamžiku dokončení nahrazení.
Odvolejte klíč, který už nepotřebujete
Stiskněte Odvolat na jeho řádku a potvrďte jeho názvem. Odvolaný klíč zmizí ze seznamu aktivních klíčů a nelze ho vrátit.
Zkontrolujte, zda nějaký nikdo nepoužívá
Projděte seznam a hledejte řádek bez údaje "Naposledy použit před", zejména mezi klíči s plným přístupem, a pokud ho nedokážete vysvětlit, odvolejte ho.