Referenties

De CLI heeft een API-token nodig om te communiceren met de OpenCX API. Inloggegevens kunnen afkomstig zijn uit een lokaal bestand of uit omgevingsvariabelen.

#Inloggegevensbestand

Na het uitvoeren van opencx auth login, worden inloggegevens opgeslagen op:

~/.opencx/credentials

Het bestand is JSON met twee velden:

{
  "token": "your-api-key",
  "api_url": "https://api.open.cx"
}

Bestandsrechten zijn ingesteld op 0600 (alleen lezen/schrijven door de eigenaar) om het token te beschermen tegen andere gebruikers op het systeem.

#Oplossingsvolgorde

De CLI lost inloggegevens op in de volgende volgorde:

1. Omgevingsvariabelen -- OPENCX_API_KEY en OPENCX_API_URL (zie Omgevingsvariabelen)
2. Inloggegevensbestand -- ~/.opencx/credentials

Als omgevingsvariabelen zijn ingesteld, wordt het inloggegevensbestand helemaal niet gelezen. Dit maakt het veilig om beide benaderingen op dezelfde machine te gebruiken zonder conflicten.

#Opnieuw authenticeren

Als je token verloopt of wordt ingetrokken, voer dan opnieuw opencx auth login uit. De CLI zal het bestaande inloggegevensbestand overschrijven en de rechten opnieuw instellen op 0600.