Enumera las autoridades certificadoras

En esta página, se explica cómo enumerar las autoridades certificadoras (ACs) en un Google Cloud proyecto.

Enumera las ACs raíz

En esta sección, se muestra cómo ver las ACs raíz.

Enumera las ACs raíz en todos los grupos de ACs

Para enumerar todas las ACs raíz en todos los grupos de ACs, haz lo siguiente:

Console

  1. En la Google Cloud consola, ve a la página Autoridades certificadoras.

    Ir a Autoridades certificadoras

  2. En el campo Filtro , selecciona Tipo en la lista.

  3. Establece el valor de Tipo como Raíz.

Se enumeran todas las ACs con Tipo establecido como Raíz.

gcloud

Ejecuta el siguiente comando:

gcloud privateca roots list --location LOCATION

Reemplaza LOCATION por la ubicación de las ACs raíz. Para obtener la lista completa de ubicaciones, consulta Ubicaciones.

Enumera las ACs raíz en un grupo de ACs en particular

Para enumerar todas las ACs raíz en un grupo de ACs en particular, usa las siguientes instrucciones:

Console

  1. Ve a la página Autoridades certificadoras.

    Ir a Autoridades certificadoras

  2. En el campo Filtro , selecciona Tipo en la lista.

  3. Establece el valor de Tipo como Raíz.

  4. En el campo Filtro, selecciona Grupo en la lista.

  5. Haz clic en el nombre del grupo de ACs en la lista.

gcloud

Ejecuta el siguiente comando:

gcloud privateca roots list --pool POOL_ID --location LOCATION

Reemplaza lo siguiente:

  • POOL_ID: Es el nombre del grupo de ACs
  • LOCATION: Es la ubicación del grupo de ACs. Para obtener la lista completa de ubicaciones, consulta Ubicaciones.

Para enumerar las ACs raíz en todos los grupos de ACs y ubicaciones, omite las marcas --pool y --location del comando.

Para obtener más información sobre el comando gcloud privateca roots list, consulta gcloud privateca roots list.

Enumera las ACs subordinadas

En esta sección, se muestra cómo ver las ACs subordinadas.

Enumera las ACs subordinadas en todos los grupos de ACs

Para enumerar todas las ACs subordinadas en todos los grupos de ACs, haz lo siguiente:

Console

  1. Ve a la página Autoridades certificadoras.

    Ir a Autoridades certificadoras

  2. En el campo Filtro , selecciona Tipo en la lista.

  3. Establece el valor de Tipo como Subordinada.

Se enumeran todas las ACs con Tipo establecido como Subordinada.

gcloud

Ejecuta el siguiente comando:

gcloud privateca subordinates list --location LOCATION

Reemplaza LOCATION por la ubicación de las ACs subordinadas. Para obtener la lista completa de ubicaciones, consulta Ubicaciones.

Enumera las ACs subordinadas en un grupo de ACs en particular

Para enumerar todas las ACs subordinadas en un grupo de ACs en particular, haz lo siguiente:

Console

  1. Ve a la página Autoridades certificadoras.

    Ir a Autoridades certificadoras

  2. En el campo Filtro , selecciona Tipo en la lista.

  3. Establece el valor de Tipo como Subordinada.

  4. En el campo Filtro , selecciona Grupo en la lista.

  5. Haz clic en el nombre del grupo de ACs en la lista.

gcloud

Ejecuta el siguiente comando:

gcloud privateca subordinates list --pool POOL_ID --location LOCATION

Reemplaza lo siguiente:

  • POOL_ID: Es el nombre del grupo de ACs
  • LOCATION: Es la ubicación del grupo de ACs. Para obtener la lista completa de ubicaciones, consulta Ubicaciones.

Para obtener más información sobre el comando gcloud privateca subordinates list, consulta gcloud privateca subordinates list.

Enumera todas las ACs

Para enumerar todas las ACs en un grupo de ACs, usa las siguientes instrucciones:

Console

  1. Ve a la página Autoridades certificadoras.

    Ir a Autoridades certificadoras

  2. En el campo Filtro , selecciona Grupo en la lista.

  3. Haz clic en el nombre del grupo de ACs en la lista.

Como alternativa, puedes ver las ACs en un grupo de ACs en particular desde la página Administrador de grupos de ACs de la siguiente manera:

  1. Haz clic en la pestaña Administrador de grupos de ACs.
  2. En la página Grupos de ACs, haz clic en el nombre del grupo de ACs cuyas ACs deseas ver.

En la página de detalles del Grupo de ACs, puedes ver las ACs que se muestran en Autoridades certificadoras en el grupo. Puedes filtrar las ACs según el tipo, el nivel, la ubicación, el estado y mucho más.

Ir

Para autenticarte en el servicio de AC, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local. 

import (
	"context"
	"fmt"
	"io"

	privateca "cloud.google.com/go/security/privateca/apiv1"
	"cloud.google.com/go/security/privateca/apiv1/privatecapb"
	"google.golang.org/api/iterator"
)

// List all Certificate Authorities present in the given CA Pool.
func listCas(w io.Writer, projectId string, location string, caPoolId string) error {
	// projectId := "your_project_id"
	// location := "us-central1"	// For a list of locations, see: https://cloud.google.com/certificate-authority-service/docs/locations.
	// caPoolId := "ca-pool-id"		// The id of the CA pool under which the CAs to be listed are present.

	ctx := context.Background()
	caClient, err := privateca.NewCertificateAuthorityClient(ctx)
	if err != nil {
		return fmt.Errorf("NewCertificateAuthorityClient creation failed: %w", err)
	}
	defer caClient.Close()

	fullCaPoolName := fmt.Sprintf("projects/%s/locations/%s/caPools/%s", projectId, location, caPoolId)

	// Create the ListCertificateAuthorities.
	// See https://pkg.go.dev/cloud.google.com/go/security/privateca/apiv1/privatecapb#ListCertificateAuthoritiesRequest.
	req := &privatecapb.ListCertificateAuthoritiesRequest{Parent: fullCaPoolName}

	it := caClient.ListCertificateAuthorities(ctx, req)
	for {
		resp, err := it.Next()
		if err == iterator.Done {
			break
		}
		if err != nil {
			return fmt.Errorf("unable to get the list of cerficate authorities: %w", err)
		}

		fmt.Fprintf(w, " - %s (state: %s)", resp.Name, resp.State.String())
	}

	return nil
}

Java

Para autenticarte en el servicio de AC, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local. 


import com.google.cloud.security.privateca.v1.CaPoolName;
import com.google.cloud.security.privateca.v1.CertificateAuthority;
import com.google.cloud.security.privateca.v1.CertificateAuthorityServiceClient;
import java.io.IOException;

public class ListCertificateAuthorities {

  public static void main(String[] args) throws IOException {
    // TODO(developer): Replace these variables before running the sample.
    // location: For a list of locations, see:
    // https://cloud.google.com/certificate-authority-service/docs/locations
    // poolId: The id of the CA pool under which the CAs to be listed are present.
    String project = "your-project-id";
    String location = "ca-location";
    String poolId = "ca-pool-id";
    listCertificateAuthority(project, location, poolId);
  }

  // List all Certificate authorities present in the given CA Pool.
  public static void listCertificateAuthority(String project, String location, String poolId)
      throws IOException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the `certificateAuthorityServiceClient.close()` method on the client to safely
    // clean up any remaining background resources.
    try (CertificateAuthorityServiceClient certificateAuthorityServiceClient =
        CertificateAuthorityServiceClient.create()) {

      // Create CA pool name comprising of project, location and the pool name.
      CaPoolName parent =
          CaPoolName.newBuilder()
              .setProject(project)
              .setLocation(location)
              .setCaPool(poolId)
              .build();

      // List the CA name and its corresponding state.
      for (CertificateAuthority certificateAuthority :
          certificateAuthorityServiceClient.listCertificateAuthorities(parent).iterateAll()) {
        System.out.println(
            certificateAuthority.getName() + " is " + certificateAuthority.getState());
      }
    }
  }
}

Python

Para autenticarte en el servicio de AC, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local. 

import google.cloud.security.privateca_v1 as privateca_v1


def list_certificate_authorities(
    project_id: str, location: str, ca_pool_name: str
) -> None:
    """
    List all Certificate authorities present in the given CA Pool.

    Args:
        project_id: project ID or project number of the Cloud project you want to use.
        location: location you want to use. For a list of locations, see: https://cloud.google.com/certificate-authority-service/docs/locations.
        ca_pool_name: the name of the CA pool under which the CAs to be listed are present.
    """

    caServiceClient = privateca_v1.CertificateAuthorityServiceClient()

    ca_pool_path = caServiceClient.ca_pool_path(project_id, location, ca_pool_name)

    # List the CA name and its corresponding state.
    for ca in caServiceClient.list_certificate_authorities(parent=ca_pool_path):
        print(ca.name, "is", ca.state)

¿Qué sigue?