API-keys en S3-keys aanmaken

Wilt u GEORIZON vanuit uw eigen software gebruiken, dan heeft u een sleutel nodig. Er zijn twee soorten, met elk een eigen doel:

Beide maakt u in uw eigen profiel. U beheert alleen uw eigen sleutels.

Eerst: een bevestigd e-mailadres

U kunt pas een API-key of S3-key aanmaken als uw e-mailadres bevestigd is. Dat voorkomt dat sleutels achterblijven bij een account waarvan niemand de eigenaar kan bereiken.

Uw adres is bevestigd als u op een gemailde link hebt geklikt, bijvoorbeeld uit de uitnodigingsmail, uit een wachtwoordreset of uit de verificatiemail in uw profiel, of als u met single sign-on hebt ingelogd. Is uw account aangemaakt via een uitnodigingslink die een beheerder u heeft doorgestuurd, dan is uw adres niet bevestigd: vraag dan de verificatiemail aan in uw profiel.

Een API-key aanmaken

1. Ga naar Profielinstellingen, API-keys.
2. Kies Nieuwe key.
3. Geef hem een omschrijving waaraan u later terugziet waarvoor hij is.
4. Kies de looptijd: 30, 90 of 365 dagen.
5. Kies de rechten die de key nodig heeft.
6. Bewaar de key.

De key wordt een keer getoond, bij het aanmaken. Daarna kan niemand hem meer opvragen, ook wij niet. Zet hem direct in uw wachtwoordmanager of in de omgevingsvariabelen van uw applicatie. Bent u hem kwijt, maak dan een nieuwe aan en trek de oude in.

Een key intrekken werkt direct: hij stopt bij het volgende verzoek.

Een S3-key aanmaken

1. Ga naar Profielinstellingen, S3-keys.
2. Kies Nieuwe key en geef een omschrijving.
3. Noteer de sleutel en het geheim.

Ook hier wordt het geheim een keer getoond, in het aanmaakvenster.

Gebruik deze instellingen in uw S3-gereedschap:

• endpoint: s3.georizon.cloud
• regio: auto

Staat uw dataset op Azure in plaats van op S3, dan werkt de S3-sleutel daar niet; gebruik dan Azure Storage Explorer. Weet u niet waar uw dataset staat, vraag het ons dan.

Oudere sleutels in de lijst

Staat er in uw lijst een sleutel van voor deze wijziging, dan ziet u die er nog bij staan en kunt u hem intrekken, maar niet opnieuw aanmaken. Maak voor een vervanging een nieuwe API-key aan.

Veiligheid

• Zet een sleutel nooit in een URL. GEORIZON leest geen sleutel meer uit een webadres, omdat zo'n adres in logboeken, browsergeschiedenis en doorverwijzingen terechtkomt.
• Maak een sleutel per toepassing, met een omschrijving. Dan kunt u er een intrekken zonder de rest te raken.
• Een wachtwoordwijziging beeindigt uw andere sessies en toestemmingen. Uw sleutels blijven daarbij geldig, behalve wanneer de reset de eerste bevestiging van uw adres was.