Comencemos con las API

Acerca de
las API de Infoblox

Las API de BloxOne son servicios web RESTful que permiten a los usuarios interactuar con Infoblox Cloud Service Platform (CSP). Las API están disponibles para las dos aplicaciones principales impulsadas por la plataforma BloxOne e incluyen:

  • API de BloxOne DDI: se utilizan para administrar y automatizar los servicios DDI de Infoblox en la nube
  • API de BloxOne Threat Defense: permiten a las organizaciones gestionar el aspecto de seguridad de red de la infraestructura de BloxOne Threat Defense.

Siga estos sencillos pasos para empezar a usar las API de BloxOne:

  1. Configure su cuenta de BloxOne [Opcional]
  2. Cree cuentas de servicio
  3. Comprenda la autenticación de solicitudes de API
  4. Cree su clave API
  5. Realice una llamada a la API
    1. Uso de Postman
    2. Uso de Curl

Configure su cuenta de BloxOne [Opcional]

Póngase en contacto con su representante de ventas en Infoblox para obtener una cuenta de BloxOne.

Cree su clave API (consulte el paso 4).

Las API de BloxOne requieren que se proporcione una clave para la autenticación.

Establezca usuarios de cuenta de servicio

Para las integraciones, deberá permitir que las aplicaciones de terceros accedan al Portal de servicios en la nube a través de la API. Esto se logra mediante el establecimiento de usuarios de cuentas de servicio. Por diseño, los usuarios de cuentas de servicio no pueden iniciar sesión en el Portal de servicios en la nube. En su lugar, creará claves API para su uso que otorgan acceso. Cada clave de API de servicio está asociada a un usuario de cuenta de servicio. A un usuario de cuenta de servicio se le pueden asociar hasta 10 claves de API de servicio. Para obtener más información, consulte Configurar claves API de servicio.

Comprenda las claves de API y la autenticación

Una clave API es un token de autenticación que se pasa a la API BloxOne para facilitar la autenticación de usuario (interactiva o de servicio) en una solicitud de API. La clave de API actúa como un token secreto para la autenticación y se le asigna un conjunto de acceso específico para un usuario. Todos los usuarios que tengan permiso para iniciar sesión en el Portal de servicios en la nube pueden crear claves de API de usuario por sí mismos. La clave de API de usuario se puede utilizar para rastrear y controlar el uso de la API, por ejemplo, para evitar el uso malintencionado o el abuso de la API.

Para autenticar las solicitudes de API, debe incluir un encabezado HTTP de «Autorización» con la clave de API y el prefijo «Token».

A continuación se muestra un ejemplo de solicitud de API utilizando comandos curl en formato JSON:

curl -k -i -H "Authorization: Token <YOUR API Key>" "https://csp.infoblox.com/api/dnsdata/v2/dns_event?source=rpz&t0=1483228800&t1=1514764799"

Cree claves de API

1. Inicie el Portal de servicios en la nube desde un navegador.

2. Autentique con sus credenciales de usuario recién obtenidas/existentes.

3. Cuando llegue a la página de inicio, pase el cursor sobre su nombre en la parte inferior izquierda de la pantalla y seleccione Perfil de usuario.

4. Haga clic en la pestaña Claves de API de usuario y seleccione Crear.

5. En la ventana emergente, especifique el Nombre y la Fecha de caducidad. Asegúrese de que la fecha de caducidad es posterior a la fecha de creación de la clave API.

6. Seleccione Guardar y cerrar.

7. Verá su clave API en la parte superior de la pantalla. Asegúrese de copiarla y guardarla en una plataforma de confianza.

Realice su primera llamada API

Haremos una simple llamada a la API para obtener todos los espacios IP de su organización.

Uso de Postman:

Postman es una plataforma de colaboración API que se utiliza para realizar solicitudes REST, SOAP o GraphQL. Si aún no tiene la aplicación, puede descargarla aquí.

1. Inicie Postman.

2. Seleccione Crear una solicitud.

3. Asegúrese de seleccionar GET en el menú desplegable.

4. Introduzca la siguiente URL en el cuadro de entrada:

https://csp.infoblox.com/api/ddi/v1/ipam/ip_space

5. En la pestaña Autorización, seleccione Clave API como Tipo.

6. Introduzca la autorización como clave.

7. Introduzca el token seguido de su clave API (formato: Token <api-key>) como Valor.

8. Haga clic en Enviar para realizar la llamada a la API.

9. Puede ver los resultados de la llamada en la sección Cuerpo según el ejemplo a continuación.

El resultado de la API GET devuelve una lista de todos los objetos existentes (en este ejemplo, Espacios IP) con todos los detalles asociados.

Uso de Curl:

Curl se utiliza en líneas de comandos o scripts para transferir datos. Obtenga más información aquí.

Si aún no lo tiene instalado en su sistema, puede descargarlo aquí.

1. Abra un terminal.

2. Reemplace el valor api-key y ejecute el siguiente comando:

curl --location --request GET 'https://csp.infoblox.com/api/ddi/v1/ipam/ip_space' \
--header 'Authorization: Token <api-key>'

3. Puede ver los resultados según el ejemplo a continuación.

¿Quiere probar BloxOne Threat Defense
de forma gratuita?

Empezar
Volver arriba