In diesem Dokument wird die programmatische Authentifizierung bei Pub/Sub beschrieben. Wie Sie sich bei Pub/Sub authentifizieren, hängt von der Schnittstelle ab, über die Sie auf die API zugreifen, und von der Umgebung, in der Ihr Code ausgeführt wird.
Hinweis: In Pub/Sub werden API-Schlüssel nicht als Authentifizierungsmethode unterstützt.Weitere Informationen zur Google Cloud Authentifizierung finden Sie unter Authentifizierungsmethoden.
API-Zugriff
Pub/Sub unterstützt den programmatischen Zugriff. Sie haben folgende Möglichkeiten, um auf die API zuzugreifen:
Clientbibliotheken
Die Pub/Sub-Clientbibliotheken bieten allgemeine Sprachunterstützung für die programmatische Authentifizierung bei Pub/Sub. Zur Authentifizierung von Aufrufen an Google Cloud -APIs unterstützen Clientbibliotheken Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC); die Bibliotheken suchen nach Anmeldedaten an einer Reihe von definierten Speicherorten und verwenden diese zur Authentifizierung von Anfragen an die API. Mit ADC können Sie Anmeldedaten für Ihre Anwendung in verschiedenen Umgebungen bereitstellen, z. B. in der lokalen Entwicklung oder Produktion, ohne den Anwendungscode ändern zu müssen.
Google Cloud CLI
Wenn Sie die gcloud CLI verwenden, um auf Pub/Sub zuzugreifen, melden Sie sich in der gcloud CLI mit einem Nutzerkonto an, das die von der gcloud CLI-Befehlen verwendeten Anmeldedaten bereitstellt.
Wenn die Sicherheitsrichtlinien Ihrer Organisation verhindern, dass Nutzerkonten die erforderlichen Berechtigungen haben, können Sie die Identitätsübernahme des Dienstkontos verwenden.
Weitere Informationen finden Sie unter Für die Verwendung der gcloud CLI authentifizieren. Weitere Informationen zur Verwendung der gcloud CLI mit Pub/Sub, finden Sie unter den Referenzseiten zur Google Cloud CLI.
REST
Sie können sich bei der Pub/Sub API mithilfe Ihrer gcloud CLI-Anmeldedaten oder mithilfe der Standardanmeldedaten für Anwendungen authentifizieren. Weitere Informationen zur Authentifizierung für REST-Anfragen finden Sie unter Für die Verwendung von REST authentifizieren. Informationen zu den Arten von Anmeldedaten finden Sie unter gcloud CLI-Anmeldedaten und ADC-Anmeldedaten.
Nutzeranmeldedaten und ADC für Pub/Sub
Eine Möglichkeit, Anmeldedaten für ADC bereitzustellen, ist die Verwendung der gcloud CLI, um Ihre Nutzeranmeldedaten in eine Datei mit Anmeldedaten einzufügen. Diese Datei wird auf Ihrem lokalen Dateisystem abgelegt, wo ADC sie finden kann. ADC verwendet dann die bereitgestellten Nutzeranmeldedaten zur Authentifizierung von Anfragen. Diese Methode wird häufig für die lokale Entwicklung verwendet.
Wenn Sie diese Methode verwenden, kann bei der Authentifizierung bei Pub/Sub ein Authentifizierungsfehler auftreten. Weitere Informationen zu diesem Fehler und seiner Behebung finden Sie unter Nutzeranmeldedaten funktionieren nicht.
Authentifizierung für Pub/Sub einrichten
Wie Sie die Authentifizierung einrichten, hängt von der Umgebung ab, in der Ihr Code ausgeführt wird.
Am häufigsten werden folgende Optionen zum Einrichten der Authentifizierung verwendet. Weitere Optionen und Informationen zur Authentifizierung finden Sie unter Authentifizierungsmethoden.
Für eine lokale Entwicklungsumgebung
Sie können Anmeldedaten für eine lokale Entwicklungsumgebung auf folgende Weise einrichten:
- Nutzeranmeldedaten für Clientbibliotheken oder Tools von Drittanbietern
- Nutzeranmeldedaten für REST-Anfragen über die Befehlszeile
- Identitätsübernahme des Dienstkontos
Clientbibliotheken oder Tools von Drittanbietern
Richten Sie Standardanmeldedaten für Anwendungen (ADC) für Ihre lokale Umgebung ein.
-
Installieren Sie die Google Cloud CLI. Initialisieren Sie die Google Cloud CLI nach der Installation mit dem folgenden Befehl:
gcloud initWenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.
-
Wenn Sie eine lokale Shell verwenden, erstellen Sie lokale Anmeldedaten zur Authentifizierung für Ihr Nutzer konto: