Autenticación

Las API de DigiCert CertCentral utilizan las claves API tanto para la autenticación como para la autorización. Autenticarse en el servicio debería ser relativamente sencillo si alguna vez trabajó con la autenticación basada en encabezados.

Autenticación basada en encabezados

Cada solicitud del servicio debe incluir una clave API. Esto se realiza utilizando el encabezado HTTP personalizado X‑DC‑DEVKEY. A continuación, se muestra una solicitud API simple para el terminal Mencionar usuarios de la API de servicios utilizando cURL.

Asegúrese de reemplazar {{api_key}} por su clave API real.

bash
curl -X GET \
  'https://www.digicert.com/services/v2/user' \
  -H 'Content-Type: application/xml' \
  -H 'X-DC-DEVKEY: {{api_key}}'

Generar una clave API

Después de que se generar una clave, solo la mostraremos una vez. No hay forma de recuperar una clave API perdida. Si alguna vez pierde una clave, deberá revocarla y generar una nueva.

Las claves API se generan y administran en su cuenta de CertCentral. Para generar una nueva clave, inicie sesión en su cuenta de CertCentral.

  1. En su cuenta de CertCentral, en el menú lateral, haga clic en Automatización > de las claves APE.

  2. En la página Claves API, haga clic en Agregar clave API.

  3. En la ventana Agregar clave API, ingrese una Descripción para la nueva clave.

    Por ejemplo, ingrese el nombre de la aplicación o el usuario al que está vinculando la clave.

  4. En el menú desplegable Usuario, seleccione el usuario al que desea vincular la clave.

Tenga en cuenta que, al vincular una clave a un usuario, está vinculando los permisos de ese usuario a la clave. Esto significa que se autorizará a la clave a realizar cualquier acción que el usuario pueda hacer.

  1. (Opcional) Para limitar los permisos de las claves API a un conjunto determinado de acciones, en el menú desplegable Restricciones de las claves API (opcional), elija una de estas opciones:

  2. Haga clic en Agregar clave API.

  3. En la ventana Nueva clave API, haga clic en la clave generada para copiarla.

  4. Guarde la clave en un lugar seguro. (Recuerde que la clave solo se muestra esta única vez).

  5. Después de haber guardado la clave, haga clic en Entiendo que no volveré a ver esto.

Qué sigue

Ahora está listo para comenzar a utilizar las API de DigiCert CertCentral. Su nueva clave API se agrega a la lista de claves en la página Acceso a la cuenta. Vuelva a esta página para rastrear (activas y revocadas) o revocar las claves API.

Editar una clave API

Según sea necesario, puede editar una clave API para actualizar la descripción o modificar los permisos de las claves.

  1. En su cuenta de CertCentral, en el menú lateral, haga clic en Automatización > de las claves APE.

  2. En la página Claves API, haga clic en el enlace Agregar nombre de la clave API.

  3. En la ventana Actualizar clave API, modifique la Descripción o actualice los permisos de la clave API.

  4. Para eliminar las restricciones de las claves API, en el campo Restricciones de las claves API (opcional), haga clic en la X que se encuentra al final de la entrada. Ahora el cambio dirá Ninguna.

  5. Para actualizar los permisos de las claves API, en el menú desplegable Restricciones de las claves API (opcional), seleccione una de estas opciones:

Tenga en cuenta que, al agregar restricciones de permisos a una clave API activa, romperá las integraciones que utilizan esa clave si se necesitan mayores permisos. Para reparar estas integraciones, deberá editar la clave y eliminar las restricciones.

  1. Haga clic en Agregar clave API para actualizar.

Información relacionada