Documentation sur Oracle Cloud Infrastructure

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

Créez un abonnement HTTPS (URL personnalisée) dans le service d'avis.

Avant de commencer

Assurez-vous que le point d'extrémité 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, voir RFC-2617 : Authentification HTTP : Authentification d'accès de base et Digest. Vous pouvez spécifier un nom d'utilisateur et un mot de passe dans l'URL, par exemple https://user:password@domain.com ou https://user@domain.com. Dans l'URL, encodez (échappez) les caractères indiqués dans le document RFC-3986 : URI : Syntaxe générique.
Certificats
Seuls les certificats d'autorité de certification valides sont approuvés. Aucun certificat auto-signé n'est autorisé.
Cryptage
Comme pour tout protocole d'abonnement, les données du point d'extrémité (y compris le nom d'utilisateur et le mot de passe s'ils sont fournis dans l'URL) sont chiffrées en transit par la connexion SSL établie lors de l'utilisation du protocole HTTPS et au repos dans la base de données du service.
appels POST
Le point d'extrémité que vous fournissez doit accepter les appels POST. Le service d'avis utilise des appels POST pour envoyer des messages aux points d'extrémité HTTPS (URL personnalisée).
Accessibilité au public

Le point d'extrémité de l'abonnement HTTPS (URL personnalisée) doit être accessible au public.

Le service Avis ne prend pas en charge les points d'extrémité privés pour les abonnements HTTPS (URL personnalisée). Le service Avis envoie une demande HTTP POST à votre point d'extrémité au moyen du réseau Internet public lorsque vous créez un abonnement HTTPS (URL personnalisée) dans un sujet.

Pour vérifier si votre point d'extrémité est accessible au public, envoyez un exemple de demande POST à partir de votre machine locale.

Exemple :

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

Si votre point d'extrémité est accessible au public, la commande retourne le code de statut HTTP suivant : 

200 OK
En-tête non autorisé

Le service du client doit prendre en charge la réponse HTTP/1.1 401 Unauthorized header. Lorsque votre point d'extrémité reçoit une demande non authentifiée, il doit retourner 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 HTTP : authentification d'accès Basic et Digest.

Exemple :

WWW-Authenticate: Basic

Les paramètres d'interrogation 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 au point d'extrémité de l'URL, le service d'avis ajoute des métadonnées standard à la demande HTTP dans l'en-tête.

  • Ces étapes montrent comment ouvrir le panneau Créer un abonnement à partir de la page de détails du sujet auquel vous voulez ajouter l'abonnement. Vous pouvez également ouvrir ce panneau à partir de la page de liste Abonnements, en spécifiant le sujet dans le panneau : Sélectionnez Créer un abonnement, puis sélectionnez un sujet d'abonnement.
    1. Dans la page de liste Sujets, sélectionnez le sujet avec lequel vous voulez travailler. Si vous avez besoin d'aide pour trouver la page de liste ou le sujet, voir Liste des sujets.
    2. Dans la page des détails du sujet, 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 comme point d'extrémité, dans le format suivant : 
      https://<anyvalidURL>
      Note

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

    Le service d'avis crée l'abonnement HTTPS (URL personnalisée) et envoie une URL de confirmation à son point d'extrémité. L'URL de confirmation est valide pendant trois (3) jours. L'abonnement est en attente jusqu'à la 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> [...]

    Pour la liste complète des paramètres et valeurs des commandes de l'interface de ligne de commande, voir Référence de ligne de commande pour les avis.

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

Étape suivante

Pour activer le nouvel abonnement, naviguez jusqu'à l'URL de confirmation qui a été envoyée au point d'extrémité HTTPS.

Bien qu'un nouvel abonnement doit se trouver dans le même compartiment que son sujet parent, vous pouvez le déplacer vers un autre compartiment après sa création. Voir Déplacement d'un abonnement vers un autre compartiment.