Reutilizar configurações de política em suas definições de política de Gerenciamento de API

APLICA-SE A: Todas as camadas de gerenciamento de API

Este artigo mostra como criar e usar fragmentos de política em suas definições de política de Gerenciamento de API do Azure. Os fragmentos de política são trechos XML reutilizáveis e gerenciados centralmente que contêm uma ou mais configurações de política de Gerenciamento de API.

Os fragmentos de política ajudam a configurar políticas de forma consistente e a manter as definições de política sem a necessidade de repetir ou redigitar o código XML.

Um fragmento de política:

• Deve ser um XML válido que contenha uma ou mais configurações de política.
• Pode incluir expressões de política, se uma política referenciada as suportar.
• É inserido as-is numa definição de política através da política include-fragment.

Limitações:

• Um fragmento de política não pode incluir um identificador de seção de política (<inbound>, <outbound>, por exemplo) ou o <base/> elemento .
• Atualmente, um fragmento de política não pode aninhar outro fragmento de política.
• O tamanho máximo de um fragmento de política é de 32 KB.

Pré-requisitos

Se você ainda não tiver uma instância de Gerenciamento de API e uma API de back-end, consulte:

• crie uma instância da Gestão de API do Azure
• Importe e publique uma API

Embora não seja necessário, convém configurar uma ou mais definições de política. Você pode copiar elementos de política dessas definições ao criar fragmentos de política.

Vá para a sua instância de Gestão de API

1. No Portal do Azure , procure e selecione Serviços de Gestão de API:

   

2. Na página de serviços de Gerenciamento de API, selecione sua instância de Gerenciamento de API:

   

Criar um fragmento de política

1. No painel esquerdo da instância de Gerenciamento de API, em APIs, selecione Fragmentos de política. No painel Fragmentos de política , selecione + Criar.

2. Na janela Criar um novo fragmento de política , insira um Nome e, opcionalmente, uma Descrição do fragmento de política. O nome deve ser exclusivo dentro da sua instância de Gerenciamento de API.

   Nome de exemplo: ForwardContext

3. No editor de fragmentos de política XML , digite ou cole um ou mais elementos XML de política entre as <fragment> tags e </fragment> :

   

   Por exemplo, o fragmento a seguir contém uma configuração de set-header política para encaminhar informações de contexto para um serviço de back-end. Esse fragmento seria incluído em uma seção de política de entrada. As expressões de política neste exemplo acessam a variávelcontext.

   <fragment>
       <set-header name="x-request-context-data" exists-action="override">
         <value>@(context.User.Id)</value>
         <value>@(context.Deployment.Region)</value>
       </set-header>
   </fragment>
   

4. Selecione Criar. O fragmento é adicionado à lista de fragmentos de política.

Incluir um fragmento numa definição de política

Use a política include-fragment para inserir um fragmento de política em uma definição de política. Para obter mais informações sobre definições de política, consulte Definir ou editar políticas.

• Você pode incluir um fragmento em qualquer escopo e em qualquer seção de política, desde que a política ou políticas subjacentes no fragmento ofereçam suporte ao uso.
• Você pode incluir vários fragmentos de política em uma definição de política.

Por exemplo, insira o fragmento de política chamado ForwardContext na seção de política de entrada:

<policies>
    <inbound>
        <include-fragment fragment-id="ForwardContext" />
        <base />
    </inbound>
[...]

Gerenciar fragmentos de política

Depois de criar um fragmento de política, você pode exibir e atualizar suas propriedades ou excluí-lo a qualquer momento.

Para exibir as propriedades de um fragmento de política:

1. No painel esquerdo da instância de Gerenciamento de API, em APIs, selecione Fragmentos de política. Selecione o nome do seu fragmento.
2. Na página Visão geral, reveja as referências dos documentos de política para ver as definições de política que contêm o fragmento.
3. Na página Propriedades , em Configurações, revise o nome e a descrição do fragmento de política. O nome não pode ser alterado.

Para editar um fragmento de política:

1. No painel esquerdo da instância de Gerenciamento de API, em APIs, selecione Fragmentos de política. Selecione o nome do seu fragmento.
2. Em Configurações, selecione Editor de políticas.
3. Atualize as instruções no fragmento e selecione Aplicar.

Para excluir um fragmento de política:

1. No painel esquerdo da instância de Gerenciamento de API, em APIs, selecione Fragmentos de política. Selecione o nome do seu fragmento.
2. Revise as referências do documento de política para obter definições de política que incluam o fragmento. Antes de excluir um fragmento, você deve remover as referências de fragmento de todas as definições de política.
3. Depois que todas as referências forem removidas, selecione Excluir.

Conteúdos relacionados

Para obter mais informações sobre como trabalhar com políticas, consulte:

• Tutorial: Transforme e proteja sua API
• Referência de Política para uma lista completa de declarações de políticas e as suas configurações
• Expressões de política
• Definir ou editar políticas
• Reutilizar configurações de políticas
• Repositório de fragmentos de política
• Política de recompra de parques infantis
• Kit de ferramentas de política de Gerenciamento de API do Azure
• Obtenha assistência do Copilot para criar, explicar e resolver problemas com políticas