Documentación de Oracle Cloud Infrastructure

Creación de una suscripción de HTTPS (URL personalizada)

Cree una suscripción de HTTPS (URL personalizada) en Notifications.

Antes de empezar

Asegúrese de que el punto final de URL que planea utilizar para la suscripción cumple los siguientes requisitos:

Autenticación
Sólo está soportada la autenticación de acceso básica. Para obtener más información, consulte RFC-2617: HTTP Authentication: Basic and Digest Access Authentication. Puede especificar un nombre de usuario y una contraseña en la URL, como en https://user:password@domain.com o https://user@domain.com. En la URL, codifique (escape) los caracteres indicados en RFC-3986: Uniform Resource Identifier (URI): Generic Syntax.
Certificados
Sólo se confía en certificados de autoridad de certificación (CA) válidos. No se permite ningún certificado autofirmado.
Cifrado
Al igual que con cualquier protocolo de suscripción, los datos del punto final (incluidos el nombre de usuario y la contraseña, si se proporcionan en la URL) se cifran en tránsito a través de la conexión SSL establecida al utilizar HTTPS, y en reposo en la base de datos del servicio.
Llamadas POST
El punto final que proporcione debe aceptar llamadas POST. El servicio Notificaciones utiliza llamadas POST para enviar mensajes a puntos finales HTTPS (URL personalizada).
Accesibilidad pública

El punto final de la suscripción HTTPS (URL personalizada) debe ser de acceso público.

Notifications no soporta puntos finales privados para suscripciones HTTPS (URL personalizada). Notifications realiza una solicitud HTTP POST al punto final a través de la red pública de internet cuando usted crea una suscripción HTTPS (URL personalizada) en un tema.

Para comprobar si el punto final es de acceso público, realice una solicitud POST de ejemplo desde la máquina local.

Ejemplo:

curl -X POST <endpoint> -H "Content-Type:text/plain; charset=UTF-8" --data {"key":"value"} -v

Si el punto final es de acceso público, el comando devuelve el siguiente código de estado HTTP: 

200 OK
encabezado no autorizado

El servicio de cliente debe poder soportar la respuesta HTTP/1.1 401 Unauthorized header. Cuando el punto final recibe una solicitud no autenticada, debe devolver esa respuesta con una cabecera WWW-Authenticate. El valor de cabecera debe contener la palabra clave Basic y otros parámetros opcionales soportados en RFC-2617: HTTP Authentication: Basic and Digest Access Authentication.

Ejemplo:

WWW-Authenticate: Basic

No se permiten parámetros de consulta en las URL. Los parámetros de cabecera HTTP personalizados no están soportados. Cuando se envía un mensaje al punto final de la URL, el servicio de notificaciones agrega metadatos estándar a la solicitud HTTP en la cabecera.

  • En estos pasos se muestra cómo abrir el panel Crear suscripción desde la página de detalles del tema al que desea agregar la suscripción. También puede abrir este panel desde la página Suscripciones y especificar el tema en el panel: haga clic en Crear suscripción y, a continuación, seleccione un tema de suscripción.
    1. En la página de lista Temas, seleccione el tema con el que desea trabajar. Si necesita ayuda para buscar la página de lista o el tema, consulte Lista de temas.
    2. En la página de detalles del tema, seleccione Crear suscripción.
    3. En el panel Crear suscripción, en Protocolo, seleccione HTTPS (URL personalizada).
    4. Introduzca la URL que desea utilizar como punto final con el siguiente formato: 
      https://<anyvalidURL>
      Nota

      Asegúrese de que la URL cumple los requisitos proporcionados al principio de este tema de ayuda. Los parámetros de consulta no están permitidos en las URL.
    5. Haga clic en Crear.

    Notifications crea la suscripción HTTPS (URL personalizada) y envía una URL de confirmación a su punto final. La suscripción está pendiente hasta que se recibe la confirmación.

  • Utilice el comando oci ons subscription create y los parámetros necesarios para crear una suscripción HTTPS (URL personalizada):

    oci ons subscription create --protocol "CUSTOM_HTTPS" --subscription-endpoint <URL> [...]

    Para obtener una lista completa de parámetros y valores para los comandos de la CLI, consulte la Command Line Reference for Notifications.

  • Ejecute la operación CreateSubscription para crear una suscripción HTTPS (URL personalizada).

Siguiente paso

Para activar la nueva suscripción, navegue hasta la URL de confirmación que se envió al punto final HTTPS.

Aunque una nueva suscripción debe estar en el mismo compartimento que su tema principal, puede moverla a otro compartimento después de la creación. Consulte Movimiento de una suscripción.