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-
Senden Sie eine
POST-Anforderung an den Registrierungsendpunkt für{database-ocid}. -
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 Wert0wird nicht unterstützt.
-
-
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_idundclient_secret, die für die OAuth-Authentifizierung erforderlich sind. Wenn das Client Secret eine Ablaufzeit hat, enthältclient_secret_expires_atden Ablaufzeitstempel.client_secret_expires_atist 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. -
Speichern Sie die zurückgegebenen OAuth-Clientzugangsdaten und Umleitungs-URIs sicher.
-
Verwenden Sie die zurückgegebenen
client_id,client_secretundredirect_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).