Habilitar Acceso a API

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

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

Habilitar Acceso a API

Cuando habilitas el acceso a API, estableces credenciales para solicitudes de API de lectura-escritura o solo lectura y generas una Clave de API, que identifica tu cuenta en las solicitudes que realizas a las API de WatchGuard. WatchGuard Cloud admite el acceso a API tanto para cuentas Service Provider como cuentas Subscriber. Para obtener más información sobre las estadísticas del uso de API pública de WatchGuard en tu cuenta, consulta Uso de API.

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

Para habilitar el acceso a API:

  1. Inicia sesión en WatchGuard Cloud.
    Si eres un Service Provider, en Gestor de Cuenta, selecciona Mi Cuenta o una cuenta gestionada.
  2. Selecciona Administración > Acceso Gestionado.

  3. Haz clic en Habilitar Acceso a API.

  4. Especifica las contraseñas de lectura-escritura o solo lectura que se deben usar como credenciales de acceso a 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. Marca la casilla de selección Acepto los términos y condiciones del Acuerdo de Licencia de API de WatchGuard.
    Puedes hacer clic en Ver el Acuerdo de Licencia de API de WatchGuard para leer los detalles del acuerdo.
  6. Haz clic en Guardar.

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

  • ID de Acceso (Lectura-escritura) — Especifica este ID y la contraseña de lectura-escritura como las credenciales en una solicitud de API para generar un token de acceso a API que permita el acceso de lectura-escritura.
  • ID de acceso (Solo lectura) — Especifica este ID y la contraseña de solo lectura como las credenciales en una solicitud de API para generar un token de acceso a API que permita el acceso de solo lectura.
  • URL de API de Autenticación — Para generar un token de acceso, envía una solicitud a la URL de este endpoint de la API de Autenticación de WatchGuard.
  • URL de API (base) — La URL base para las solicitudes de API públicas de WatchGuard.
  • Clave de API — Especifica 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 en tu cuenta WatchGuard Cloud.

Las API públicas de WatchGuard utilizan autenticación basada en token. En cada solicitud a una API de WatchGuard, debes especificar una Clave de API, que identifica tu cuenta, y un token de acceso, que autoriza el acceso a API durante un periodo de tiempo. Para obtener un token de acceso, envía 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 tu cuenta.

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

Cambia tus contraseñas de API

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

  1. En tu cuenta Subscriber de WatchGuard Cloud, selecciona Administración > Acceso Gestionado.
    Si eres un Service Provider, en Gestor de Cuenta, selecciona Mi Cuenta.

Screen shot of RESTful API Access enabled

  1. Haz clic en Cambiar Contraseñas.

    Screen shot of the Change Passwords page.

  2. Especifica contraseñas nuevas de lectura-escritura y solo lectura.
  3. Marca la casilla de selección Acepto los términos y condiciones del Acuerdo de Licencia de API de WatchGuard.
    Puedes hacer clic en Ver el Acuerdo de Licencia de API de WatchGuard para leer los detalles del acuerdo.
  4. Haz clic en Cambiar Contraseñas.

Revocar el Acceso a API

Para revocar el acceso a API en tu cuenta WatchGuard Cloud:

  1. Inicia sesión en tu cuenta WatchGuard Cloud.
    Si eres un Service Provider, en Gestor de Cuenta, selecciona Mi Cuenta.
  2. Selecciona Administración > Acceso Gestionado.
  3. Haz clic en Revocar el Acceso.

    Screen shot of RESTful API Access enabled

Ver También

Dashboard de Uso de API

Ayuda de la API de WatchGuard

Configurar MFA para un RESTful API Client