Una identidad de servicio en Google Distributed Cloud (GDC) aislado proporciona una identidad dedicada para que las cargas de trabajo o los servicios accedan de forma programática a los recursos y microservicios de manera segura. Estas son identidades especiales que usan las aplicaciones o las cargas de trabajo, en lugar de una persona, y no se pueden usar para el acceso humano. Al igual que con las cuentas de usuario, otorgas permisos y roles a una identidad de servicio para definir a qué puede acceder.
Es posible que notes que se usan dos términos para este concepto. La consola de GDC
usa principalmente el término identidad de servicio, mientras que los comandos de gdcloud y las interacciones
con la API suelen usar cuenta de servicio. Este último refleja el nombre del
recurso personalizado de Kubernetes subyacente, ProjectServiceAccount. Ambos términos se refieren
a lo mismo: la identidad no humana para tus cargas de trabajo. En este
documento, se usa identidad de servicio como el término principal.
Las identidades de servicio son útiles para administrar la infraestructura de GDC, como las siguientes:
- Servicios y cargas de trabajo internos de Distributed Cloud para acceder de forma segura a la interfaz de programación de aplicaciones (API) del plano de control de Distributed Cloud. Por ejemplo, los servicios de base de datos que interactúan con las APIs de Kubernetes para crear y borrar bases de datos.
- Las cargas de trabajo de los clientes en Distributed Cloud para acceder a los servicios de Distributed Cloud y realizar llamadas autorizadas a la interfaz de programación de aplicaciones (API). Por ejemplo, las identidades de servicio pueden administrar un cliente que usa un notebook de Vertex AI Workbench para transcribir archivos de audio con la API de Speech-to-Text.
- Cargas de trabajo externas para federar con Distributed Cloud. Por ejemplo, las identidades de servicio pueden administrar una aplicación externa a Distributed Cloud que digitaliza documentos, pero quiere usar la API de reconocimiento óptico de caracteres (OCR) para reemplazar su motor de OCR actual.
- Distributed Cloud o los controladores del sistema para acceder de forma segura a los recursos de los clientes o a los clústeres de usuarios. Por ejemplo, las identidades de servicio pueden administrar flujos de trabajo de autenticación y autorización en los que los controladores de servicio que se ejecutan en clústeres de administrador deben ejecutar cargas de trabajo dentro de los clústeres de usuario que administran los clientes.
La administración de las identidades de servicio involucra tanto la identidad de servicio (representada por
un recurso ProjectServiceAccount) como sus credenciales asociadas (pares de claves públicas y
privadas). Puedes administrar cuentas para identidades de servicio con la consola de GDC, la CLI de gdcloud o la API. Con la
CLI de gdcloud, la función de identidad de servicio se basa en la API
global de ProjectServiceAccount. Debido a que los recursos de ProjectServiceAccount se
configuran de forma global, operan en todas las zonas de tu
universo de gdcloud.
Antes de comenzar
Para completar las tareas de este documento, debes tener un proyecto. Para aprender a crear un proyecto, consulta Crea un proyecto.
También debes tener los permisos necesarios y preparar tu entorno.
Solicita roles de IAM
Para crear, actualizar y borrar identidades de servicio dentro de un proyecto, comunícate con tu
administrador de la organización de IAM o con el administrador del proyecto de IAM para solicitar el rol de administrador del proyecto de IAM
(project-iam-admin).
El administrador de IAM de la organización puede otorgar este rol para cualquier proyecto dentro de la organización. El administrador de IAM del proyecto puede otorgar este rol dentro del alcance de su proyecto específico.
Prepara el entorno
Para usar las herramientas de línea de comandos y administrar las identidades de servicio, completa la siguiente configuración:
Para usar la API con
kubectl, se requiere una configuración adicional:- Instala la CLI de kubectl.
- Genera el archivo kubeconfig para el servidor de la API global
para configurar el acceso a
kubectl.
Crea una identidad de servicio
Crear una identidad de servicio incluye crear una cuenta y sus credenciales asociadas.
Crear una cuenta
Para crear una cuenta para una identidad de servicio, usa la consola de GDC, la
CLI de gdcloud o la API para crear un recurso ProjectServiceAccount
en un proyecto.
Console
- Accede a la consola de GDC.
- En el menú de navegación, selecciona Identidad y acceso > Identidades de servicio.
- Haz clic en Crear identidad de servicio. Se abrirá la página Detalles de la identidad del servicio.
- En el campo Nombre de la identidad de servicio, ingresa un nombre para la identidad de servicio. Por ejemplo:
testserviceidentity. - Haz clic en Crear.
gdcloud
Crea una cuenta:
gdcloud iam service-accounts create NAME \
--project=PROJECT
Reemplaza los siguientes valores:
- NAME: Es el nombre de
ProjectServiceAccount. El nombre debe ser único dentro del espacio de nombres del proyecto. - PROJECT: Es el proyecto en el que se creará la identidad
de servicio. Si ya se estableció
gdcloud init, omite la marca--project.
Este comando crea un ProjectServiceAccount en el espacio de nombres del proyecto en
el servidor de la API de Management.
API
Crea un archivo YAML de recurso personalizado
ProjectServiceAccount, comomy-project-sa.yaml:apiVersion: resourcemanager.global.gdc.goog/v1 kind: ProjectServiceAccount metadata: name: NAME namespace: PROJECT spec: keys: - algorithm: ALGORITHM id: KEY_ID key: BASE64_ENCODED_KEY validAfter: "START_TIME" validBefore: "EXPIRATION_TIME"Reemplaza las siguientes variables:
NAME: Es el nombre del recursoProjectServiceAccount. El nombre debe ser único dentro del espacio de nombres del proyecto.PROJECT: Es el proyecto en el que se creará la identidad de servicio.ALGORITHM: Es el algoritmo de la clave. Solo se admiten claves ES256.KEY_ID: Es el identificador único de la clave. El ID se usa para determinar con qué clave se debe verificar.BASE64_ENCODED_KEY: Es la clave pública codificada en Base64 en formato PEM con la que se realizará la verificación. La clave privada que se usa para generar esta clave pública se espera en formato ECDSA P256 PEM.START_TIME: Es la hora de inicio en la que la clave se vuelve válida, como2025-02-07T00:59:34Z.EXPIRATION_TIME: Es la hora de vencimiento de la clave, como2026-02-07T00:59:34Z.
Aplica el recurso personalizado
ProjectServiceAccountal servidor de la API global:kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG apply -f my-project-sa.yamlReemplaza la variable
GLOBAL_API_SERVER_KUBECONFIGpor la ruta de acceso al archivo kubeconfig del servidor de la API global.
Crear credenciales
Para permitir que una carga de trabajo o aplicación se autentique como la identidad de servicio (representada por la cuenta que creaste), debes generar credenciales. La creación de credenciales implica generar un par de claves criptográficas públicas y privadas, y asociar la clave pública con la identidad del servicio.
Para crear credenciales para una identidad de servicio, usa la consola de GDC, la CLI de gdcloud o la API.
Console
- Accede a la consola de GDC.
- En el menú de navegación, selecciona Identidad y acceso > Identidades de servicio.
- Haz clic en el nombre de la identidad de servicio que deseas agregar en la clave.
- Haz clic en Crear clave nueva.
- La clave nueva aparecerá en la lista Claves y un diálogo confirmará que la creaste correctamente.
gdcloud
El comando gdcloud crea un archivo JSON de credenciales predeterminadas de la aplicación
y un par de claves pública y privada:
gdcloud iam service-accounts keys create APPLICATION_DEFAULT_CREDENTIALS_FILENAME \
--project=PROJECT \
--iam-account=NAME \
--ca-cert-path=CA_CERTIFICATE_PATH
Reemplaza los siguientes valores:
- APPLICATION_DEFAULT_CREDENTIALS_FILENAME: Es el nombre del archivo JSON.
- PROJECT : Selecciona el proyecto para el que se creará la clave.
Si ya se estableció
gdcloud init, puedes omitir la marca--project. - NAME: Es el nombre de la identidad de servicio a la que se agregará la clave.
- CA_CERTIFICATE_PATH: Es la ruta de acceso al certificado de la autoridad certificada (AC) para verificar el extremo de autenticación (opcional). Si no especificas esta ruta de acceso, se usarán los certificados de la AC del sistema. Debes instalar la AC en los certificados de la AC del sistema.
Distributed Cloud agrega la clave pública a las claves de ProjectServiceAccount
que usas para verificar los tokens web JSON (JWT) que firma la clave privada. La
clave privada se escribe en el archivo JSON de credenciales predeterminadas de la aplicación.
En el siguiente ejemplo, se muestra el archivo JSON de las credenciales predeterminadas de la aplicación:
{
"type": "gdch_service_account",
"format_version": "1",
"project": "project_name",
"private_key_id": "abcdef1234567890",
"private_key": "-----BEGIN PRIVATE KEY-----\nETC\n-----END PRIVATE KEY-----\n",
"name": "service_identity_name",
"ca_cert_path": "/path/to/ca.crt",
"token_uri": "https://service-identity.<Domain>/authenticate"
}
En este ejemplo, se usan los siguientes valores:
project: Es el espacio de nombres del proyecto en la organización.private_key_id: Es el ID asignado a la clave.private_key: Es la clave privada ECDSA P256 en formato PEM que genera la CLI.name: Es el nombre de la identidad del servicio.ca_cert_path: Es la ruta de acceso al certificado de la autoridad certificadora (AC) que se usa para verificar el extremo de autenticación.token_uri: Es la dirección del extremo de autenticación.
API
Genera el par de claves pública y privada. En los siguientes comandos, se usa
opensslcomo ejemplo, que es una herramienta común para este propósito.openssl ecparam -name prime256v1 -genkey -noout -out "key.pem" openssl ec -in "key.pem" -pubout > "pub.pem"Codifica en Base64 la clave pública y recupera su ID de clave:
KEY_ID=$(openssl pkey -in key.pem -pubout -outform der | openssl dgst -sha256 | sed 's/^.* //') BASE64_ENCODED_KEY=$(cat pub.pem | base64)Crea o actualiza el archivo YAML del recurso personalizado
ProjectServiceAccount, incluida la información de la clave generada en el paso anterior:apiVersion: resourcemanager.global.gdc.goog/v1 kind: ProjectServiceAccount metadata: name: NAME namespace: PROJECT spec: keys: - algorithm: ALGORITHM id: KEY_ID key: BASE64_ENCODED_KEY validAfter: "START_TIME" validBefore: "EXPIRATION_TIME"Reemplaza las siguientes variables:
NAME: Es el nombre del recursoProjectServiceAccount. El nombre debe ser único dentro del espacio de nombres del proyecto.PROJECT: el proyecto en el que creas la clave.ALGORITHM: Es el algoritmo de la clave. Solo se admiten claves ES256.KEY_ID: Es el identificador único de la clave. El ID se usa para determinar con qué clave se debe verificar.BASE64_ENCODED_KEY: Es la clave pública codificada en Base64 en formato PEM con la que se realizará la verificación. La clave privada que se usa para generar esta clave pública se espera en formato ECDSA P256 PEM.START_TIME: Es la hora de inicio en la que la clave se vuelve válida, como2025-02-07T00:59:34Z.EXPIRATION_TIME: Es la hora de vencimiento de la clave, como2026-02-07T00:59:34Z.
Aplica el recurso personalizado
ProjectServiceAccountal servidor de la API global:kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG apply -f my-project-sa.yamlReemplaza la variable
GLOBAL_API_SERVER_KUBECONFIGpor la ruta de acceso al archivo kubeconfig del servidor de la API global.Crea el archivo JSON de credenciales predeterminadas de la aplicación que contiene la clave privada. Asegúrate de que la variable
KEY_IDdel archivo JSON esté configurada con el mismo valor que la variableKEY_IDque usaste en la especificaciónProjectServiceAccount.cat <<EOF > "key_file.json" { "format_version": "1", "name": "NAME", "private_key": "$(tr '\n' '\t' < "key.pem" | sed 's/\t/\\n/g')", "private_key_id": "KEY_ID", "project": "PROJECT", "token_uri": "AUTH_URL", "type": "gdch_service_account" } EOFReemplaza las siguientes variables:
NAME: Es el nombre de la identidad del servicio.KEY_ID: Es el identificador único de la clave. El ID se usa para determinar con qué clave se debe verificar y debe coincidir con el valorKEY_IDque se usa en la especificaciónProjectServiceAccount.PROJECT: Es el espacio de nombres del proyecto en la organización.AUTH_URL: Es la dirección del extremo de autenticación.
Para obtener detalles sobre cómo usar el archivo de claves generado para autenticarte como esta identidad de servicio, consulta Autentica y usa una identidad de servicio. En esta sección, se explica cómo usar la clave con la CLI de gdcloud y de manera programática con las bibliotecas cliente.
Visualiza las identidades de servicio
En esta sección, se describe cómo ver tus identidades de servicio y sus claves públicas asociadas.
Consulta una lista de identidades de servicio
Para ver una lista de las identidades de servicio dentro de un proyecto, usa la consola de GDC o la CLI de gdcloud.
Console
- Accede a la consola de GDC.
- Selecciona un proyecto.
- En el menú de navegación, haz clic en Identidad y acceso > Identidades de servicio para ver la lista de identidades de servicio del proyecto.
gdcloud
Enumera las cuentas de identidad de servicio en un proyecto:
gdcloud iam service-accounts list \
--project=PROJECT
Reemplaza PROJECT por el ID del proyecto.
Visualiza una lista de claves públicas para una identidad de servicio
Enumera las claves públicas registradas con una cuenta de identidad de servicio en el proyecto:
gdcloud iam service-accounts keys list \
--project=PROJECT \
--iam-account=NAME
Reemplaza lo siguiente:
- PROJECT: Es el ID del proyecto.
- NAME: Es el nombre de la cuenta de identidad de servicio que se usará.
Otorga permisos para las identidades de servicio
Para otorgar permisos a una identidad de servicio, asígnale uno o más roles creando vinculaciones de roles con la consola de GDC o la CLI de gdcloud.
Console
- Accede a la consola de GDC.
- Selecciona un proyecto.
- En el menú de navegación, selecciona Identidad y acceso > Acceso.
- En la lista Miembro, haz clic en Agregar miembro. Verás la página Usuarios y roles.
- Selecciona Identidad de servicio en la lista Tipo de miembro.
- En la lista Identidad de servicio, selecciona la identidad de servicio a la que deseas asignar una vinculación de rol.
- En la lista Rol, selecciona el rol que deseas asignar a la identidad de servicio, como Creador de copias de seguridad.
- Opcional: Para agregar otro rol, haz clic en Agregar otro rol. Selecciona el rol adicional.
- Haz clic en Agregar.
gdcloud
Puedes vincular la cuenta de identidad de servicio a roles dentro del espacio de nombres del proyecto o a roles en un espacio de nombres diferente.
Vincula la cuenta a un rol dentro del espacio de nombres del proyecto:
gdcloud iam service-accounts add-iam-policy-binding \ --project=PROJECT \ --role=ROLE \ --iam-account=NAMEReemplaza lo siguiente:
- PROJECT: Es el proyecto en el que se creará la vinculación de rol. Si ya se estableció
gdcloud init, puedes omitir la marca--project. - ROLE: Es el rol predefinido que se asignará a la
cuenta. Especifica los roles en el formato
Role/name, en el que Role es el tipo de KubernetesIAMRoley name es el nombre del rol predefinido. Por ejemplo, para asignar el rol de visualizador de proyectos, establece el rol enIAMRole/project-viewer. - NAME: Es el nombre de la cuenta de identidad de servicio que se usará.
- PROJECT: Es el proyecto en el que se creará la vinculación de rol. Si ya se estableció
Vincula la cuenta a un rol dentro de un espacio de nombres diferente:
gdcloud iam service-accounts add-iam-policy-binding \ --role=ROLE \ --role-namespace=ROLE_NAMESPACE \ --iam-account=NAMEReemplaza lo siguiente:
- ROLE: Es el rol predefinido que se asignará a la
cuenta. Especifica los roles en el formato
Role/name, en el que Role es el tipo de KubernetesIAMRoley name es el nombre del rol predefinido. Por ejemplo, para asignar el rol de visualizador de proyectos, establece el rol enIAMRole/project-viewer. - ROLE_NAMESPACE: Es el espacio de nombres del rol que se vinculará con la cuenta, que no sea el espacio de nombres del proyecto.
- NAME: Es el nombre de la cuenta de identidad de servicio que se usará.
- ROLE: Es el rol predefinido que se asignará a la
cuenta. Especifica los roles en el formato
Autentica y usa una identidad de servicio
Después de crear una identidad de servicio y generar su archivo de claves, puedes usar el archivo de claves para autenticarte en los servicios y clústeres de GDC. La autenticación te permite obtener tokens de acceso de corta duración para las llamadas a la API o configurar el acceso al clúster.
Existen dos formas de autenticar con una identidad de servicio:
Autentícate con la CLI de gdcloud
Para realizar acciones con la identidad de servicio, primero debes activar su archivo de claves. Después de la activación, puedes usar la CLI de gdcloud para obtener tokens o generar archivos kubeconfig.
Autoriza una identidad de servicio con una clave
El comando gdcloud auth activate-service-account autentica la
CLI de gdcloud con una identidad de servicio. Esto te permite realizar acciones en
los recursos de Distributed Cloud con los permisos de la cuenta de identidad de servicio
en lugar de una cuenta de usuario.
Autoriza una identidad de servicio con una clave:
Crea un archivo de claves de credenciales, si aún no tienes uno.
Activa la identidad del servicio ejecutando el siguiente comando:
gdcloud auth activate-service-account --key-file=KEY_FILEReemplaza KEY_FILE por la ruta de acceso al archivo de claves de credenciales, que suele estar en formato JSON.
Después de la activación correcta,
gdcloudusa las credenciales de la identidad de servicio en lugar de tus credenciales de usuario.
Obtén un token de acceso con la CLI de gdcloud
Después de autorizar una identidad de servicio, puedes usar gdcloud para imprimir un token de acceso. Puedes usar este token como un token del portador para autenticar solicitudes HTTP.
El token otorga acceso a los servicios, como se define en el
parámetro AUDIENCES.
Imprime un token de identidad para la cuenta de identidad de servicio especificada:
gdcloud auth print-identity-token --audiences=AUDIENCES
Reemplaza AUDIENCES por el destinatario o servicio previsto para el que se usará el token. Solo se puede especificar un público.
Genera el archivo kubeconfig
Después de autorizar una identidad de servicio, puedes generar un archivo kubeconfig para autenticarte en los clústeres de Kubernetes.
Configura la propiedad gdcloud
core/organization_console_url:gdcloud config set core/organization_console_url https://GDC_URLReemplaza
GDC_URLpor la URL de tu organización.Genera el archivo kubeconfig para acceder a un clúster con la identidad de servicio activa:
Para un clúster zonal, haz lo siguiente:
export KUBECONFIG=KUBECONFIG_PATH gdcloud clusters get-credentials CLUSTER_NAME --zone ZONEReemplaza lo siguiente:
- KUBECONFIG_PATH: Es la ruta de acceso en la que deseas guardar el archivo kubeconfig generado.
CLUSTER_NAME: Es el nombre del clúster zonal.
ZONE: el nombre de la zona en la que se encuentra el clúster.
Para el servidor de la API global:
export KUBECONFIG=KUBECONFIG_PATH gdcloud clusters get-credentials global-apiReemplaza
KUBECONFIG_PATHpor la ruta de acceso en la que deseas guardar el archivo kubeconfig generado.
Se genera un archivo kubeconfig, configurado para autenticarse como la identidad del servicio. A continuación, se muestra un archivo YAML de ejemplo:
apiVersion: v1
clusters:
- cluster:
certificate-authority-data: <REDACTED>
server: <REDACTED>
name: cluster-name
contexts:
- context:
cluster: cluster-name
user: gdch_console-<REDACTED>_cluster-name
name: cluster-name-gdch_console-<REDACTED>_cluster-name
current-context: cluster-name-gdch_console-gdc1-staging-gpcdemolabs-com_cluster-name
kind: Config
preferences: {}
users:
- name: gdch_console-<REDACTED>_cluster-name
user:
exec:
apiVersion: client.authentication.k8s.io/v1
args:
- --audience=<REDACTED>
command: gdcloud-k8s-auth-plugin
env: null
installHint: Run 'gdcloud components install gdcloud-k8s-auth-plugin' to use
plugin
interactiveMode: Never
provideClusterInfo: false
Autentica de forma programática con bibliotecas cliente
En los siguientes ejemplos, se muestra cómo autenticarse de manera programática en
las APIs de GDC con las
bibliotecas cliente de Google Cloud estándar. Estas
bibliotecas usan el
archivo de claves de la cuenta de servicio generado para
generar un token de acceso del Servicio de tokens de seguridad (STS) o configurar un cliente de servicio
con las credenciales de la identidad del servicio. Este método no requiere ninguna
autorización previa de gdcloud.
Python
import google.auth
from google.auth.transport import requests
import requests as reqs
api_endpoint = "https://console.org-1.zone1.google.gdch.test"
# Load the GDC credentials (via GOOGLE_APPLICATION_CREDENTIALS or default path)
creds, project_id = google.auth.default()
# Apply the required audience for the GDC Management API
creds = creds.with_gdch_audience(api_endpoint)
def fetch_gdch_token():
sesh = reqs.Session()
# Note: Set verify to False only if bypassing self-signed cert verification.
# Otherwise, rely on the "ca_cert_path" present in your gdch_credentials.json
sesh.verify = False
req = requests.Request(session=sesh)
# Refresh the credentials to fetch the STS access token
creds.refresh(req)
print("Access Token:", creds.token)
fetch_gdch_token()
Java
import com.google.auth.oauth2.GdchCredentials;
import com.google.auth.oauth2.GoogleCredentials;
import java.io.FileInputStream;
import java.io.InputStream;
public class GdchAuthExample {
public static void main(String[] args) throws Exception {
// Path to your service account JSON file
String credentialsPath = "/path/to/gdch/credentials.json";
String apiAudience = "https://console.org-1.zone1.google.gdch.test";
try (InputStream credentialsStream = new FileInputStream(credentialsPath)) {
// Load the generic Google credentials from the stream
GoogleCredentials credentials = GoogleCredentials.fromStream(credentialsStream);
// Verify it loaded as GdchCredentials
if (credentials instanceof GdchCredentials) {
// Cast and attach the targeted GDC audience
GdchCredentials gdch = ((GdchCredentials) credentials).createWithGdchAudience(apiAudience);
// Force negotiation with the GDC Auth Server to fetch the token
gdch.refreshIfExpired();
System.out.println("Access Token: " + gdch.getAccessToken().getTokenValue());
} else {
System.err.println("The provided file is not a valid GdchCredentials format.");
}
}
}
}
Go
package main
import (
"context"
"fmt"
"log"
"cloud.google.com/go/auth/credentials"
)
func main() {
ctx := context.Background()
apiEndpoint := "https://console.org-1.zone1.google.gdch.test"
// Load default credentials. The STSAudience parameter is specifically
// required for the GDC auth flow to correctly negotiate the token.
creds, err := credentials.DetectDefault(&credentials.DetectOptions{
STSAudience: apiEndpoint,
})
if err != nil {
log.Fatalf("Failed to detect credentials: %v", err)
}
// Fetch an access token
token, err := creds.Token(ctx)
if err != nil {
log.Fatalf("Failed to retrieve token: %v", err)
}
fmt.Printf("Access Token: %s\n", token.Value)
}
C++
[](std::string const& keyfile, std::string const& audience) {
auto is = std::ifstream(keyfile);
is.exceptions(std::ios::badbit); // Minimal error handling in examples
auto contents = std::string(std::istreambuf_iterator<char>(is.rdbuf()), {});
auto options =
google::cloud::Options{}.set<google::cloud::UnifiedCredentialsOption>(
google::cloud::MakeGDCHServiceAccountCredentials(contents, audience));
return google::cloud::speech_v1::AdaptationClient(
google::cloud::speech_v1::MakeAdaptationConnection(options));
}
Borra una identidad de servicio
Después de borrar una identidad de servicio, se borran la ProjectServiceAccount y sus
claves públicas asociadas, las claves privadas existentes dejan de ser válidas y
las aplicaciones ya no tienen acceso a los recursos del proyecto a través de esa identidad
de servicio.
Para borrar una identidad de servicio, usa la consola de GDC o la CLI de gdcloud.
Console
- Accede a la consola de GDC.
- En el menú de navegación, selecciona Identidad y acceso > Identidades de servicio.
- Selecciona la casilla de verificación de la identidad de servicio que deseas borrar.
- Haz clic en Borrar.
- Aparecerá el diálogo de confirmación. En el campo Para confirmar, escribe lo siguiente, ingresa
remove. - Haz clic en Borrar.
gdcloud
Ejecuta el siguiente comando para borrar una cuenta de identidad de servicio:
gdcloud iam service-accounts delete NAME \
--project=PROJECT
Reemplaza lo siguiente:
- NAME: Es el nombre de la cuenta de identidad de servicio que se borrará.
- PROJECT: Es el ID del proyecto.
Borrar credenciales
Si deseas inhabilitar un par de claves específico sin borrar toda la cuenta de identidad de servicio, puedes borrar su clave pública de la cuenta de identidad de servicio. Esta acción invalida la clave privada correspondiente.
Para borrar la clave pública, usa la consola de GDC o la CLI de gdcloud.
Console
- Accede a la consola de GDC.
- En el menú de navegación, selecciona Identidad y acceso > Identidades de servicio.
- Haz clic en el nombre de la identidad de servicio que tiene la clave que deseas borrar.
- Haz clic en Borrar.
- En el diálogo de confirmación, haz clic en Borrar.
gdcloud
Quita la clave pública con el ID de clave de una cuenta de identidad de servicio en el proyecto:
gdcloud iam service-accounts keys delete KEY_ID \
--project=PROJECT \
--iam-account=NAME
Reemplaza lo siguiente:
- KEY_ID: Es el identificador único de la clave.
- PROJECT: Es el ID del proyecto.
- NAME: Es el nombre de la cuenta de identidad de servicio.