OAuth-Client (OAuth) registrieren

Registrieren Sie einen OAuth-Client, um Zugangsdaten für den Zugriff auf den Oracle Autonomous AI Database A2A-Server zu generieren und eine sichere Authentifizierung für die A2A-Clientintegration zu ermöglichen.

Hinweis

Hinweis: Nur der Datenbankbenutzer ADMIN kann Clientzugangsdaten erstellen.

Endpunkt

POST https://dataaccess.adb.{region-identifier}.oraclecloudapps.com/adb/auth/v1/connect/databases/{database-ocid}/register
  1. Senden Sie eine POST-Anforderung an den Registrierungsendpunkt für {database-ocid}.

  2. Geben Sie die Anforderungs-Payload mit der Umleitungs-URI und dem Clientnamen an. Die Anforderungs-Payload unterstützt das optionale Attribut client_secret_expires_in_mins, um die Ablaufzeit des OAuth-Client Secret zu steuern.

    Anforderungsbody

    {
      "redirect_uris": ["{customer-provided-redirect-url}"],
      "client_name": "{customer-provided-client name}",
      "client_secret_expires_in_mins": 123456
    }

    Ersetzen Sie die Platzhalter durch Ihre spezifischen Werte.

    • redirect_uris: URL, bei der der der OAuth 2.0- oder OpenID Connect-Provider Benutzer nach erfolgreicher Authentifizierung umleitet

    • client_name: Benutzerdefinierter Name zur Identifizierung des Clients (Beispiel: DbA2AClient)
    • client_secret_expires_in_mins: (Optional) Anzahl der Minuten, bevor das Client Secret abläuft. Wird er ausgelassen, läuft das Client Secret nicht ab. Geben Sie eine positive Ganzzahl ein. Der Wert 0 wird nicht unterstützt.
  3. Prüfen Sie die Registrierungsantwort, und notieren Sie die generierten Clientzugangsdaten.

    Antwortformat

    {
    "client_name": "{customer-provided-client name}",
    "client_id": "{generated-client-id}",
    "client_secret": "{generated-client-secret}",
    "client_id_issued_at": {issue-timestamp},
    "client_secret_expires_at": {expiration-timestamp},
    "redirect_uris": ["{customer-provided-redirect-url}"],
    "response_types": ["code"],
    "grant_types": [
                "authorization_code",
                "refresh_token"
                    ],
    "token_endpoint_auth_method": "client_secret_post",
    "scope": "openid"
    }

    Die Antwort enthält die generierten client_id und client_secret, die für die OAuth-Authentifizierung erforderlich sind. Wenn das Client Secret eine Ablaufzeit hat, enthält client_secret_expires_at den Ablaufzeitstempel. client_secret_expires_at ist ein absoluter Zeitstempel, der die Anzahl der Sekunden seit der Unix-Epoche (1. Januar 1970, UTC) darstellt, wenn das Client Secret abläuft. Ein Wert von 0 bedeutet, dass das Secret nicht abläuft.

  4. Speichern Sie die zurückgegebenen OAuth-Clientzugangsdaten und Umleitungs-URIs sicher.

  5. Verwenden Sie die zurückgegebenen client_id, client_secret und redirect_uris, um die OAuth-Authentifizierung in A2A-Client-Agents zu konfigurieren.

Beispiel: OAuth-Client (OAuth) registrieren

curl -X POST 'https://dataaccess.adb.{region-identifier}.oraclecloudapps.com/adb/auth/v1/connect/databases/{database-ocid}/register' \
  -u 'db-admin-username:password' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "redirect_uris": ["{customer-provided-redirect-url}"],
    "client_name": "{customer-provided-client name}",
    "client_secret_expires_in_mins": 123456
  }'

Antwort auf die OAuth-Clientanforderung:

{
  "client_name": "DbA2AClient",
  "client_id": "ocid1.a2a.client.oc1..exampleuniqueID",
  "client_secret": "AbCdEf1234567890SecretValue",
  "client_id_issued_at": 1712345678,
  "client_secret_expires_at": 0,
  "redirect_uris": ["https://myapp.example.com/oauth/callback"],
  "response_types": ["code"],
  "grant_types": [
    "authorization_code",
    "refresh_token"
		],
  "token_endpoint_auth_method": "client_secret_post",
  "scope": "openid"
}

OAuth-Client mit der Registrierungsantwort konfigurieren: Die API-Antwort gibt die OAuth-Clientzugangsdaten (wie client_id und client_secret) und Umleitungs-URIs für den registrierten Client zurück.

Verwenden Sie die zurückgegebenen client_id, client_secret und redirect_uris, um die OAuth-Authentifizierung in A2A-Client-Agents zu konfigurieren (z.B. Google Gemini Enterprise Application oder ein anderer A2A-kompatibler Client). Weitere Informationen finden Sie unter Agent über Google Marketplace konfigurieren (Administrator) und Benutzerdefinierten Agent konfigurieren (Administrator).