Authenticate to Pub/Sub Lite

Stay organized with collections Save and categorize content based on your preferences.

This document describes how to authenticate to Pub/Sub Lite programmatically.

For more information about Google Cloud authentication, see the authentication overview.

API access

Pub/Sub Lite supports programmatic access. How you authenticate to Pub/Sub Lite depends on how you access the API. You can access the API in the following ways:

Client libraries

The Pub/Sub Lite client libraries provide high-level language support for authenticating to Pub/Sub Lite programmatically. Client libraries support Application Default Credentials (ADC); the libraries look for credentials in a set of defined locations and use those credentials to authenticate requests to the API. With ADC, you can make credentials available to your application in a variety of environments, such as local development or production, without needing to modify your application code.

To use ADC, you must first provide your credentials to ADC.

Google Cloud CLI

When you use the gcloud CLI to access Pub/Sub Lite, you log in to the gcloud CLI with a Google Account, which provides the credentials used by the gcloud CLI commands.

If your organization's security policies prevent user accounts from having the required permissions, you can impersonate a service account, either by using the impersonate_service_account property or by using the --impersonate-service-account flag, which affects only the command for which you use it.

For more information about using the gcloud CLI with Pub/Sub Lite, see the gcloud CLI reference pages.


You can authenticate to Pub/Sub Lite from the command line by using Application Default Credentials. For more information, see Authenticate using REST.

If you want to use the API without using a client library, you can use Google's authentication library for your programming language. Alternatively, you can implement authentication in your code.

Access control in Pub/Sub Lite

When you grant roles to a principal, always grant roles with only the required permissions; granting broader roles, such as basic roles, violates the principle of least privilege.

For more information about the roles for Pub/Sub Lite, see Access control with IAM. For more information about Identity and Access Management (IAM) and authorization, see IAM overview.

What's next