Importation d'une stratégie définie par l'utilisateur dans un catalogue

Créer une stratégie définie par l'utilisateur et propre au catalogue qui peut être utilisée dans les assemblages d'API au sein du catalogue où la stratégie est publiée.

A propos de cette tâche

Note : Dans API Connectcette fonction n'est disponible qu'avec le plan avancé.

Une politique publiée à l'échelle d'un catalogue ne peut être utilisée qu'avec les API du même catalogue. Effectuez les tâches suivantes pour définir, mettre en forme et publier la stratégie adaptée au catalogue.

Procédure

  1. Créez un fichier « YAML » qui décrit la nouvelle stratégie relative au catalogue.
    1. Créez un fichier nommé <policyname>.yaml.
    2. Collez le contenu suivant dans le nouveau fichier :
      attach:
      - rest
      - soap
      policy: 1.0.0
      info:
        title: <policyname>
        name: <policyname>
        version: 1.0.0
        description: <description-here>
      properties:
        $schema: 'http://json-schema.org/draft-04/schema#'
        type: object
        properties:
          exampleProperty:
            label: Test Property
            description: Enter any value
            type: string
          exampleProperty2:
            label: Another Test Property
            description: Enter any value
            type: string
        required:
          - exampleProperty2
      gateways:
      - datapower-api-gateway
    3. Modifiez le contenu si nécessaire pour décrire correctement votre nouvelle politique relative aux catalogues.
    4. Sauvegardez et fermez le fichier.
  2. Créez un nouveau fichier d' zip s appelé <policyname>.zip qui contient le nouveau fichier YAML.
  3. Publier la nouvelle politique qui utilise soit la CLI de la boîte à outils, soit le gestionnaire d'API :
    • API Connect boîte à outils CLI :

      Utilisez la apic policies:create commande pour publier l'extension de passerelle (voir la documentation de référence de l'interface CLI de la boîte à outils ).

    • API Manager :

      Pour publier la nouvelle politique, procédez comme suit :

      1. Connectez-vous à API Manager.
      2. Cliquez sur « Gérer les catalogues » > Sélectionnez un catalogue > Passerelles > passerelle_sélectionnée > Icône Actions > Affichez les règles et téléchargez votre nouveau policy.zip fichier.
  4. Vérifiez que la nouvelle stratégie relative au catalogue est disponible dans la palette Stratégie de l'API Assembler.
    1. Dans API Manager, sélectionnez le catalogue dans lequel vous avez publié la nouvelle règle de portée catalogue.
    2. Créer une API.
    3. Cliquez sur Icône des paramètres (à côté de « Enregistrer » ) et, dans le champ « Catalogue cible », sélectionnez le catalogue dans lequel vous avez publié la nouvelle stratégie.
    4. Sauvegardez l'API.
    5. Ouvrez la page API Assembler et affichez la palette Policy. Vérifiez que votre nouvelle politique définie par le catalogue s'affiche et peut être ajoutée à l'API.