Informationen zu OAuth-Endpunkten

<ph type="x-smartling-placeholder"></ph> Sie sehen die Dokumentation zu Apigee Edge.
Gehen Sie zur Apigee X-Dokumentation. Weitere Informationen

Um einen Job als OAuth2-Autorisierungsserver ausführen zu können, muss Apigee Edge Endpunkte verfügbar machen, bei denen Clients Tokens und Auth-Codes anfordern können. In diesem Thema wird eine kurze Einführung in diese Endpunkte vorgestellt. Außerdem erfahren Sie, wie Sie sie in Edge einrichten.

Was ist ein OAuth2-Endpunkt?

Ein OAuth2-Endpunkt ist eine URL, die Clients aufrufen können, um OAuth-Token (oder Authentifizierungscodes) anzufordern. Hier sehen Sie eine Beispielanfrage für ein Zugriffstoken:

$ curl -i -H 'ContentType: x-www-form-urlencoded' \
-X POST 'https://docs-test.apigee.net/oauth/client_credential/accesstoken' \
-d 'grant_type=client_credentials' \
-H 'Authorization: Basic c3FIOG9vSGV4VHo4QzAySVg5T1JvNnJoZ3ExaVNyQWw6WjRsanRKZG5lQk9qUE1BVQ'

In Ihrer Apigee Edge-Umgebung ist eine Richtlinie zur Verarbeitung dieser Art von Anfrage erforderlich. Wie Sie aus der Anfrage ableiten können, muss die Richtlinie den Gewährungstyp "Clientanmeldedaten" unterstützen und die Richtlinie muss unter dem Pfad /oauth/client_credentials/accesstoken ausgeführt werden.

Die richtige Richtlinie in diesem Fall ist eine OAuthV2-Richtlinie, die zur Ausführung in einem Ablauf konfiguriert ist, wie im folgenden Beispiel.

        <Flow name="AccessTokenClientCredential">
            <Description/>
            <Request>
                <Step>
                    <FaultRules/>
                    <Name>GenerateAccessTokenClient</Name>
                </Step>
            </Request>
            <Response/>
            <Condition>(proxy.pathsuffix MatchesPath &quot;/accesstoken&quot;) and (request.verb = &quot;POST&quot;)</Condition>
        </Flow>

Wenn der Client die richtigen Anmeldeinformationen bereitstellt, generiert die Richtlinie ein Token und gibt es zurück. Andernfalls wird ein Fehler zurückgegeben.

Standardendpunkte ermitteln

Apigee fügt jeder neuen Organisation, die es erstellt, standardmäßig einen OAuth2-Endpunkt-Proxy-Proxy hinzu. In diesem Fall finden Sie in Ihrer Organisation einen Proxy namens oauth.

So finden Sie diesen Proxy:

1. Rufen Sie die Seite API-Proxies auf, wie unten beschrieben.

   Edge

   So greifen Sie über die Edge-Benutzeroberfläche auf die Seite "API-Proxies" zu:

   1. Melden Sie sich bei apigee.com/edge an.
   2. Wählen Sie in der linken Navigationsleiste Develop > API Proxies aus.
   3. Klicken Sie auf +Proxy.

   Classic Edge (Private Cloud)

   So greifen Sie über die Classic Edge-Benutzeroberfläche auf die Seite API-Proxies zu:

   1. Melden Sie sich in http://ms-ip:9000 an. ms-ip ist hierbei IP-Adresse oder DNS-Name des Verwaltungsserverknotens.
   2. Wählen Sie APIs > API-Proxys.
2. Wählen Sie in der Liste der Proxys den Proxy unter oauth aus.
3. Wählen Sie auf der Übersichtsseite zum Proxy den Tab Entwickeln aus, um den Proxy-Editor aufzurufen, und überprüfen Sie die Richtlinien und Abläufe im Proxy.

Best Practice: Benutzerdefinierten OAuth2-Endpunkt-Proxy erstellen

Der standardmäßige oauth-Proxy ist begrenzt: Er unterstützt nur die Gewährung von Clientanmeldedaten. Dieser Proxy ist nur als Beispiel vorgesehen. Für die Produktion möchten Sie einen Proxy erstellen, der die OAuth2-Endpunkte konfiguriert, die Ihren Anforderungen entsprechen.

Wichtiger Hinweis: Ein Proxy, der OAuth2-Endpunkte definiert, ist in der Regel kein No Zielproxy. Der Proxy fungiert als Dienst, der im ProxyEndpoint ausgeführt wird und direkt an den Client zurückgegeben wird.

Weitere Informationen

Zugriffstokens und Autorisierungscodes anfordern