Habilitar el Acceso a la API

WatchGuard proporciona APIs RESTful públicas que puede usar para la integración con los productos y servicios de WatchGuard. Para usar una API de WatchGuard, debe habilitar el acceso a la API RESTful en WatchGuard Cloud.

Para obtener información más detallada, consulte la Ayuda de la API de WatchGuard.

Habilitar el Acceso a la API

Cuando habilita el acceso a la API, establece credenciales para solicitudes de API de lectura-escritura y solo lectura, y genera una Clave API, que identifica su cuenta en las solicitudes que realiza a las API de WatchGuard. WatchGuard Cloud admite el acceso a la API tanto para cuentas Service Provider como cuentas Subscriber. Para obtener información sobre las estadísticas de uso de la API pública de WatchGuard para su cuenta, consulte Uso de la API.

Para habilitar el acceso a la API, debe tener el rol de operador Owner o Administrator.

Para habilitar el acceso a la API:

  1. Inicie sesión en WatchGuard Cloud.
    Si es un Service Provider, en Administrador de Cuentas, seleccione Mi Cuenta o una cuenta administrada.
  2. Seleccione Administración > Acceso Administrado.

  3. Haga clic en Habilitar el Acceso a la API.

  4. Especifique las contraseñas de lectura-escritura y solo lectura que se deben usar como credenciales de acceso a la API. Las contraseñas deben incluir una letra mayúscula, una letra minúscula, un número y un carácter especial.

    La contraseña de lectura-escritura y la contraseña de solo lectura deben ser diferentes.

  5. Marque la casilla de selección Acepto los términos y condiciones del Acuerdo de Licencia de las API de WatchGuard.
    Puede hacer clic en Ver el Acuerdo de Licencia de las API de WatchGuard para leer los detalles del acuerdo.
  6. Haga clic en Guardar.

Después de habilitar el acceso a la API, se mostrará esta información:

  • ID de Acceso (Lectura-escritura) — Especifique este ID y la contraseña de lectura-escritura como las credenciales en una solicitud de API para generar un token de acceso de la API que permita el acceso de lectura-escritura.
  • ID de acceso (Lectura solamente) — Especifique este ID y la contraseña de solo lectura como las credenciales en una solicitud de API para generar un token de acceso de la API que permita el acceso de solo lectura.
  • URL de la API de Autenticación — Para generar un token de acceso, envíe una solicitud a la URL de este endpoint de la API de Autenticación de WatchGuard.
  • URL de la API (base) — La URL base para las solicitudes de API públicas de WatchGuard.
  • Clave API — Especifique esta opción como el valor del parámetro de encabezado X-API-Key en todas las solicitudes a las API públicas de WatchGuard.

La URL de la API de Autenticación y la URL de la API (base) dependen de la región de almacenamiento de datos de su cuenta de WatchGuard Cloud.

Las API públicas de WatchGuard utilizan autenticación basada en token. En cada solicitud a una API de WatchGuard, especifique una Clave API, que identifica su cuenta, y un token de acceso, que autoriza el acceso a la API durante un período de tiempo. Para obtener un token de acceso, envíe una solicitud a la API de Autenticación de WatchGuard. La solicitud del token de acceso debe incluir las credenciales de la API de lectura-escritura codificadas en base64 para su cuenta.

Para obtener más información sobre cómo realizar solicitudes de API, consulte la Ayuda de la API de WatchGuard. Para obtener información sobre las estadísticas de uso de la API pública de WatchGuard para su cuenta, consulte Uso de la API.

Cambie sus contraseñas de API

Para cambiar las contraseñas de la API para los ID de Acceso a la API:

  1. En su cuenta Subscriber de WatchGuard Cloud, seleccione Administración > Acceso Administrado.
    Si es un Service Provider, en Administrador de Cuentas, seleccione Mi Cuenta.

Screen shot of RESTful API Access enabled

  1. Haga clic en Alterar Contraseñas.

    Screen shot of the Change Passwords page.

  2. Especifique contraseñas nuevas para lectura-escritura y solo lectura.
  3. Marque la casilla de selección Acepto los términos y condiciones del Acuerdo de Licencia de las API de WatchGuard.
    Puede hacer clic en Ver el Acuerdo de Licencia de las API de WatchGuard para leer los detalles del acuerdo.
  4. Haga clic en Alterar Contraseñas.

Revocar el Acceso a la API

Para revocar el acceso a la API para su cuenta de WatchGuard Cloud:

  1. Inicie sesión en su cuenta de WatchGuard Cloud.
    Si es un Service Provider, en Administrador de Cuentas, seleccione Mi Cuenta.
  2. Seleccione Administración > Acceso Administrado.
  3. Haga clic en Revocar el Acceso.

    Screen shot of RESTful API Access enabled

Ver También

Panel de Control de Uso de la API

Ayuda de la API de WatchGuard

Configurar la MFA para un RESTful API Client