Wenn die Identity Platform-Integration mit der reCAPTCHA Enterprise API aktiviert ist, stellt Identity Platform standardmäßig reCAPTCHA-Schlüssel in Ihrem Namen bereit. Sie können jedoch Ihren eigenen reCAPTCHA-Schlüssel für die Verwendung mit reCAPTCHA verwenden. Wenn Sie Ihren eigenen reCAPTCHA-Schlüssel hochladen, wird die Bereitstellung durch Identity Platform deaktiviert.
Funktion zum Verwenden eigener Schlüssel aktivieren
Um diese Funktion zu aktivieren und Ihren reCAPTCHA-Schlüssel hochzuladen, rufen Sie den Endpunkt mit dem folgenden curl-Befehl auf:
OAUTH_TOKEN: Die Anmeldedaten, die für Administratoranfragen verwendet werden.
PROJECT_NUMBER: die Projektnummer
KEY_VALUE: Der String, der den reCAPTCHA-Schlüssel darstellt, den Sie hochladen möchten.
PLATFORM_TYPE: Die Plattform der Anwendung, die den reCAPTCHA-Schlüssel verwendet. Gültige Werte sind WEB, ANDROID und IOS.
Funktion zum Verwenden eigener Schlüssel deaktivieren
Wenn Sie weiterhin reCAPTCHA-Schlüssel über Identity Platform bereitstellen möchten, rufen Sie den Endpunkt mit curl auf und übergeben Sie eine leere Liste für recaptchaConfig.recaptchaKeys. Beispiel:
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-09-04 (UTC)."],[[["\u003cp\u003eYou have the option to use your own reCAPTCHA key with Identity Platform's integration with the reCAPTCHA Enterprise API, instead of using the default provisioned keys.\u003c/p\u003e\n"],["\u003cp\u003eUploading your own reCAPTCHA key to Identity Platform will disable the automatic provisioning of keys by Identity Platform.\u003c/p\u003e\n"],["\u003cp\u003eTo enable the use of your own reCAPTCHA key, you must make a \u003ccode\u003ePATCH\u003c/code\u003e request to the specified endpoint using a \u003ccode\u003ecurl\u003c/code\u003e command, providing the key and platform type.\u003c/p\u003e\n"],["\u003cp\u003eYou can revert to Identity Platform's default reCAPTCHA key provisioning by sending a \u003ccode\u003ePATCH\u003c/code\u003e request with an empty list for \u003ccode\u003erecaptchaConfig.recaptchaKeys\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThis feature is currently subject to "Pre-GA Offerings Terms" and is provided "as is" with potentially limited support.\u003c/p\u003e\n"]]],[],null,["# Bring your own reCAPTCHA keys\n=============================\n\n|\n| **Preview**\n|\n|\n| This feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nYou can use your own reCAPTCHA key with\n[Identity Platform integration with the reCAPTCHA Enterprise API](/identity-platform/docs/recaptcha-enterprise).\n\nWhen the Identity Platform integration with the reCAPTCHA Enterprise API is enabled, Identity Platform provisions\nreCAPTCHA keys on your behalf by default. However, you can\nchoose to bring your own reCAPTCHA key to use with\nreCAPTCHA. Uploading your own reCAPTCHA key\ndisables the provisioning by\nIdentity Platform.\n\nEnable the ability to bring your own key\n----------------------------------------\n\nTo enable this capability and upload your reCAPTCHA key, call the\nendpoint with the following `curl` command: \n\n curl -i -X PATCH -H 'Content-Type: application/json' -H\n \"x-goog-user-project: \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e\" -H 'Authorization: Bearer \u003cvar translate=\"no\"\u003eOAUTH_TOKEN\u003c/var\u003e' -d\n '\n {\n \"recaptchaConfig\": {\n \"recaptchaKeys\": [{\"key\": \"projects/\u003cvar translate=\"no\"\u003ePROJECT_NUMBER\u003c/var\u003e/keys/\u003cvar translate=\"no\"\u003eKEY_VALUE\u003c/var\u003e\",\n \"type\": \"\u003cvar translate=\"no\"\u003ePLATFORM_TYPE\u003c/var\u003e\"}],\n },\n }'\n https://identitytoolkit.googleapis.com/v2/projects/\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e/config?updateMask=recaptchaConfig.recaptchaKeys\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003ePROJECT_ID\u003c/code\u003e\u003c/var\u003e: the project ID\n- \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003eOAUTH_TOKEN\u003c/code\u003e\u003c/var\u003e: the credential used for administrator requests\n- \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003ePROJECT_NUMBER\u003c/code\u003e\u003c/var\u003e: the project number\n- \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003eKEY_VALUE\u003c/code\u003e\u003c/var\u003e: the string that represents the reCAPTCHA key you want to upload\n- \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003ePLATFORM_TYPE\u003c/code\u003e\u003c/var\u003e: the platform of the application using the reCAPTCHA key. Valid values are `WEB`, `ANDROID`, and `IOS`.\n\nDisable the ability to bring your own key\n-----------------------------------------\n\nTo continue provisioning reCAPTCHA keys through\nIdentity Platform, call the\nendpoint with `curl` and pass an empty list for `recaptchaConfig.recaptchaKeys`. For example: \n\n curl -i -X PATCH -H 'Content-Type: application/json' -H \"x-goog-user-project:\n \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e\" -H 'Authorization: Bearer \u003cvar translate=\"no\"\u003eOAUTH_TOKEN\u003c/var\u003e' -d '\n {\n \"recaptchaConfig\": {\n \"recaptchaKeys\": [],\n },\n }'\n https://identitytoolkit.googleapis.com/v2/projects/\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e/config?updateMask=recaptchaConfig.recaptchaKeys\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003ePROJECT_ID\u003c/code\u003e\u003c/var\u003e: the project ID\n- \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003eOAUTH_TOKEN\u003c/code\u003e\u003c/var\u003e: the credential used for administrator requests"]]