OAuth 2.0 Übergangsleitfaden

Einleitung

In diesem Artikel werden die Schritte erläutert, die Sie ausführen müssen, um OAuth-Clients in Coupa zu konfigurieren, damit Sie von API-Schlüsseln zu OAuth 2.0 wechseln können.

So funktioniert es

1. API-Schlüssel in Coupa prüfen

1. Melden Sie sich bei Ihrer Coupa-Instanz an.
2. Wählen Sie „Konfiguration“ > „API-Schlüssel“.
3. Alle Schlüssel prüfen.

2. OAuth Client Erstellung und Scope Zuordnung

1. Wählen Sie „Konfiguration“ > „Oauth2/OpenID Connect-Clients“ (/oauth2/clients).
2. Klicken Sie auf Erstellen und wählen Sie im Dropdown-Menü Gewährungstyp die Option Client-Anmeldedaten aus.
3. Füllen Sie die Felder aus und wählen Sie die Bereiche (Zugriffsberechtigungen) aus, die der Kunde benötigt. Beachten Sie, dass Sie, wenn Sie einem Client Zugriff auf alle API-Endpunkte und -Operationen gewähren möchten, alle Bereiche zu diesem Client hinzufügen müssen. 
   
4. Sobald Sie den Client gespeichert haben, erhalten Sie die Client-Anmeldeinformationen: Identifier, Secret, Oidc Scopes.
   

1. Verwenden Sie das Terminal (LINK), um einen Curl-Post auszuführen:
   curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "client_id=<CLIENT_ID>&grant_type=client_credentials&scope =<SPACE_SEPARATED_LIST_OF_SCOPES>&client_secret=<CLIENT_SECRET>" https://<INSTANCE_DOMAIN>/oauth2/token
   
2. Konfigurieren Sie mit einem HTTP-Client wie Postman oder einem ANDEREN REST-Client eine OAuth2/OIDC-Clientverbindung zur Verwendung der Coupa-API.
3. Wählen Sie POST.
4. Legen Sie die URL auf den Instanznamen fest, unter dem Sie den Client oben definiert haben. Beispiel: https://{your_instance_address}/oauth2/token
5. Legen Sie den Header-Schlüsselwert für Content-Type = application/x-www-form-urlencoded fest
   
6. STELLEN Sie im Post-Body die folgenden Werte ein:
   1. client_id = <Your Client Identifier value>
   2. grant_type = client_credentials
   3. scope = <Copy/paste all the scopes that you selected in Client credentials setup without the comma.>
   4. client_secret = < Coupa Client Secret-Wert kopieren/einfügen >
      

7. Klicken Sie auf Senden. Die POST-ANTWORT verfügt über das access_token, das generiert wurde, um API-Aufrufe innerhalb des definierten Bereichs für die nächsten 24 Stunden zu autorisieren (expires_in 86.399 Sekunden). 
   

8. Kopieren Sie den Wert access_token aus dem Antworttext und verwenden Sie ihn als Token-Wert in den Autorisierungs-Headern für Ihre Coupa-API-Aufrufe innerhalb des Bereichs, den Sie für diese Client-Verbindung definiert haben. 

9. Erstellen Sie einen neuen Tab, um API-Aufrufe zum ABRUFEN, POSTEN oder SETZEN usw. durchzuführen, und definieren Sie im Autorisierungsteil des Request Builders den ‘TYPE’ = OAuth 2.0.

10. Fügen Sie das access_token als Token-Feldwert ein.
    

11. Gehen Sie zu Headers und geben Sie einen Wert von application/xml oder application/json in das Feld Accept key ein. Sie müssen die anderen Anforderungsparameter entsprechend dem Aufruf und der Schnittstelle, die Sie verwenden möchten, einstellen und definieren. Im Beispiel sehen Sie einen GET-API-Aufruf an die Invoices-API.
    

12. Klicken Sie auf Senden. Mit diesem access_token, das im Authorization-Header festgelegt ist, können Sie GET, PUT oder Post-Anrufe AN die Client-Bereiche tätigen, die Sie für diese Verbindung definiert haben.