Documentation Oracle Cloud Infrastructure

Création d'un abonnement via HTTPS (URL personnalisée)

Créez un abonnement via HTTPS (URL personnalisée) dans Notifications.

Avant de commencer

Assurez-vous que l'adresse d'URL que vous prévoyez d'utiliser pour l'abonnement répond aux exigences suivantes :

Authentification
Seule l'authentification d'accès de base est prise en charge. Pour plus d'informations, reportez-vous à RFC-2617 - Authentification HTTP : authentification d'accès de base et condensée. Vous pouvez indiquer un nom utilisateur et un mot de passe dans l'URL, comme dans https://user:password@domain.com ou https://user@domain.com. Dans l'URL, codez (échappez) les caractères indiqués à l'adresse RFC-3986 : Uniform Resource Identifier (URI) : Syntaxe générique.
Certificates
Seuls les certificats d'autorité de certification valides sont sécurisés. Aucun certificat auto-signé n'est autorisé.
cryptage
Comme pour tout protocole d'abonnement, les données de l'adresse (y compris le nom utilisateur et le mot de passe, si indiqués dans l'URL) sont cryptées en transit sur la connexion SSL établie lors de l'utilisation de HTTPS et au repos dans la base de données de service.
appels POST
L'adresse que vous fournissez doit accepter les appels POST. Le service Notifications utilise des appels POST pour envoyer des messages aux adresses HTTPS (URL personnalisée).
Accessibilité publique

L'adresse de l'abonnement via HTTPS (URL personnalisée) doit être accessible publiquement.

Notifications ne prend pas en charge les adresses privées pour les abonnements via HTTPS (URL personnalisée). Notifications envoie une demande HTTP POST à votre adresse via le réseau Internet public lorsque vous créez un abonnement via HTTPS (URL personnalisée) dans un sujet.

Pour vérifier si votre adresse est accessible publiquement, effectuez une demande POST d'exemple à partir de votre machine locale.

Exemple :

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

Si votre adresse est accessible publiquement, la commande renvoie le code de statut HTTP suivant : 

200 OK
En-tête non autorisé

Le service client doit pouvoir prendre en charge la réponse HTTP/1.1 401 Unauthorized header. Lorsque votre adresse reçoit une demande non authentifiée, elle doit renvoyer cette réponse avec un en-tête WWW-Authenticate. La valeur d'en-tête doit contenir le mot-clé Basic et d'autres paramètres facultatifs pris en charge dans RFC-2617 : authentification d'accès de base et condensée.

Exemple :

WWW-Authenticate: Basic

Les paramètres de requête ne sont pas autorisés dans les URL. Les paramètres d'en-tête HTTP personnalisés ne sont pas pris en charge. Lors de l'envoi d'un message à l'adresse d'URL, le service Notifications ajoute des métadonnées standard à la demande HTTP dans l'en-tête.

  • Ces étapes indiquent comment ouvrir le panneau Créer un abonnement à partir de la page de détails de la rubrique à laquelle ajouter l'abonnement. Vous pouvez également ouvrir ce panneau à partir de la page de liste Abonnements, en indiquant le sujet dans le panneau : sélectionnez Créer un abonnement, puis sélectionnez un sujet d'abonnement.
    1. Sur la page de liste Sujets, sélectionnez le sujet à utiliser. Si vous avez besoin d'aide pour rechercher la page de liste ou le sujet, reportez-vous à la rubrique Liste des sujets.
    2. Sur la page de détails de la rubrique, sélectionnez Créer un abonnement.
    3. Dans le panneau Créer un abonnement, pour Protocole, sélectionnez HTTPS (URL personnalisée).
    4. Entrez l'URL à utiliser en tant que point de terminaison, au format suivant : 
      https://<anyvalidURL>
      Remarque

      Assurez-vous que l'URL répond aux exigences fournies au début de cette rubrique d'aide. Les paramètres de requête ne sont pas autorisés dans les URL.
    5. Sélectionnez Créer.

    Notifications crée l'abonnement HTTPS (URL personnalisée) et envoie une URL de confirmation à son adresse. L'URL de confirmation est valide pendant trois (3) jours. L'abonnement est en attente jusqu'à réception de la confirmation.

  • Utilisez la commande oci ons subscription create et les paramètres requis pour créer un abonnement HTTPS (URL personnalisée) :

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

    Afin d'obtenir la liste complète des paramètres et des valeurs des commandes d'interface de ligne de commande, reportez-vous à Référence de ligne de commande pour Notifications.

  • Exécutez l'opération CreateSubscription pour créer un abonnement HTTPS (URL personnalisée).