Política VerifyAPIKey

Esta página se aplica à Apigee e à Apigee híbrida.

Confira a documentação da Apigee Edge.

Visão geral

A política Verify API Key permite que você aplique a verificação de chaves de API no ambiente de execução, permitindo que apenas os apps com chaves de API aprovadas acessem APIs. Essa política garante que as chaves de API sejam válidas, não sejam revogadas e sejam aprovadas para consumir os recursos específicos associados aos produtos de API.

Esta é uma política extensível. O uso dela pode ter implicações no custo ou na utilização, dependendo da sua licença da Apigee. Para informações sobre tipos de política e implicações de uso, consulte Tipos de política.

Para ver um tutorial sobre como criar um proxy de API que usa a política "Verificar chave de API", consulte Proteger uma API exigindo chaves de API.

Amostras

Chave no parâmetro de consulta

<VerifyAPIKey name="APIKeyVerifier">
    <APIKey ref="request.queryparam.apikey" />
</VerifyAPIKey>

Neste exemplo, a política espera encontrar a chave de API em uma variável de fluxo chamada request.queryparam.apikey. A variável request.queryparam.{name} é uma variável de fluxo padrão da Apigee preenchida com o valor de um parâmetro de consulta transmitido na solicitação do cliente.

O comando curl a seguir transmite a chave de API em um parâmetro de consulta:

curl http://myorg-test.apigee.net/mocktarget?apikey=IEYRtW2cb7A5Gs54A1wKElECBL65GVls

Embora seja permitido, geralmente é uma prática ineficiente passar a chave de API em um parâmetro de consulta. Isso acontece porque os parâmetros de consulta podem aparecer no histórico do navegador e registros da rede, o que pode causar um possível risco de segurança. Uma prática recomendada é colocar a chave de API em um cabeçalho, o que não aparecerá nos arquivos de registro. Veja o exemplo "KEY IN HEADER" na próxima guia.

Chave no cabeçalho

<VerifyAPIKey name="APIKeyVerifier">
    <APIKey ref="request.header.x-apikey" />
</VerifyAPIKey>

Neste exemplo, a política espera encontrar a chave de API em uma variável de fluxo chamada request.header.x-apikey. A variável request.header.{name} é uma variável de fluxo padrão da Apigee preenchida com o valor de um cabeçalho transmitido na solicitação do cliente.

O cURL a seguir mostra como transmitir a chave de API em um cabeçalho:

curl "http://myorg-test.apigee.net/mocktarget" -H "x-apikey:IEYRtW2cb7A5Gs54A1wKElECBL65GVls"

É uma prática recomendada passar a chave de API em um cabeçalho em vez de em um parâmetro de consulta. Isso acontece porque os cabeçalhos não aparecem no histórico do navegador ou nos registros da rede, o que pode causar um possível risco de segurança.

Chave na variável

<VerifyAPIKey name="APIKeyVerifier">
    <APIKey ref="requestAPIKey.key"/>
</VerifyAPIKey>

A política pode referenciar qualquer variável que contenha a chave. Neste exemplo, a política extrai a chave de API de uma variável chamada requestAPIKey.key.

Você decide como essa variável é preenchida. Por exemplo, é possível usar a política Extract Variables para preencher requestAPIKey.key de um parâmetro de consulta chamado myKey, conforme mostrado abaixo:

<ExtractVariables async="false" continueOnError="false" enabled="true" name="SetAPIKeyVar">
    <Source>request</Source>
    <QueryParam name="myKey">
        <Pattern ignoreCase="true">{key}</Pattern>
    </QueryParam>
    <VariablePrefix>requestAPIKey</VariablePrefix>
    <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
</ExtractVariables>

Acessar variáveis de fluxo de política

<AssignMessage async="false" continueOnError="false" enabled="true" name="accessverifyvars">
    <AssignVariable>
        <Name>devFirstName</Name>
        <Ref>verifyapikey.verify-api-key.developer.firstName</Ref>
        <Value>ErrorOnCopy</Value>
    </AssignVariable>
    <AssignVariable>
        <Name>devLastName</Name>
        <Ref>verifyapikey.verify-api-key.developer.lastName</Ref>
        <Value>ErrorOnCopy</Value>
    </AssignVariable>
    <AssignVariable>
        <Name>devEmail</Name>
        <Ref>verifyapikey.verify-api-key.developer.email</Ref>
        <Value>ErrorOnCopy</Value>
    </AssignVariable>
    <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
    <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>

A Apigee preenche automaticamente um conjunto de variáveis de fluxo ao executar a política Verify API Key para uma chave de API válida. Use essas variáveis para acessar informações como nome e ID do aplicativo e informações sobre o desenvolvedor ou empresa que o registrou. No exemplo acima, você usa a política Assign Message para acessar o nome, sobrenome e endereço de e-mail do desenvolvedor após a execução da política Verify API Key.

Todas essas variáveis incluem o prefixo a seguir:

verifyapikey.{policy_name}

Neste exemplo, o nome da política Verify API key é "verify-api-key". Portanto, você referencia o nome do desenvolvedor que faz a solicitação acessando a variável verifyapikey.verify-api-key.developer.firstName.

Aprender sobre a Apigee

Exemplo: aprenda fazendo!
O exemplo Proteger o proxy com uma chave de API protege um proxy de API com uma chave de API e Remover o parâmetro de consulta apikey mostra como remover a chave de API da solicitação para evitar que ela seja transmitida para o destino de back-end (uma prática recomendada). Basta clonar o repositório e seguir as instruções nos arquivos README.

---

Sobre a política de verificação de chave de API

Quando um desenvolvedor registra um aplicativo na Apigee, a Apigee automaticamente gera um par de chave de cliente e secret. A chave de cliente e o secret do aplicativo podem ser encontrados na IU da Apigee ou na API Apigee.

Observação: as chaves de API têm muitos nomes. Elas podem ser chamadas de "chaves de API", "chaves de aplicativo" e "chaves de cliente". Todos esses nomes são sinônimos.

No momento do registro do aplicativo, o desenvolvedor seleciona um ou mais produtos de API para associar ao aplicativo, sendo um produto de API um conjunto de recursos acessíveis por proxies de API. Em seguida, o desenvolvedor passa a chave de API (chave de cliente) como parte de todas as solicitações a uma API em um produto de API associado ao aplicativo. Consulte Visão geral da publicação para saber mais.

As chaves de API podem ser usadas como tokens de autenticação ou para conseguir tokens de acesso OAuth. No OAuth, as chaves de API são chamadas de "ID do cliente". Os nomes podem ser usados de forma intercambiável. Consulte Página inicial do OAuth para mais informações.

A Apigee preenche automaticamente um conjunto de variáveis de fluxo ao executar a política Verify API Key. Consulte Variáveis de fluxo abaixo para mais informações.

Referência de elemento

Veja a seguir elementos e atributos que podem ser configurados com esta política:

<VerifyAPIKey async="false" continueOnError="false" enabled="true" name="Verify-API-Key-1">
    <DisplayName>Custom label used in UI</DisplayName>
    <APIKey ref="variable_containing_api_key"/>
    <CacheExpiryInSeconds ref="request.queryparam.cache_expiry">Default value</CacheExpiryInSeconds/>
</VerifyAPIKey>

Atributos <VerifyAPIKey>

O exemplo a seguir mostra os atributos na tag <VerifyAPIKey>:

<VerifyAPIKey async="false" continueOnError="false" enabled="true" name="Verify-API-Key-1">

A tabela a seguir descreve atributos comuns a todos os elementos pai de políticas:

Atributo	Descrição	Padrão	Presença
name	O nome interno da política. O valor do atributo name pode conter letras, números, espaços, hifens, sublinhados e pontos. Esse valor não pode exceder 255 caracteres. Opcionalmente, use o elemento <DisplayName> para rotular a política no editor de proxy da IU de gerenciamento com um nome de linguagem natural diferente.	N/A	Obrigatório
continueOnError	Defina como false para retornar um erro quando uma política falhar. Esse é o comportamento esperado na maioria das políticas. Defina como true para que a execução do fluxo continue mesmo depois que uma política falhar. Consulte também: As regras de falha são acionadas SOMENTE em um estado de erro (sobre continueOnError) Como corrigir falhas no fluxo atual	falso	Opcional
enabled	Defina como true para aplicar a política. Defina como false para desativar a política. A política não será aplicada mesmo se ela permanecer anexada a um fluxo.	true	Opcional
async	Esse atributo está obsoleto.	falso	Obsoleto

Elemento <DisplayName>

Use em conjunto com o atributo name para rotular a política no editor de proxy da IU de gerenciamento com um nome de linguagem natural diferente.

<DisplayName>Policy Display Name</DisplayName>

Padrão	N/A Se você omitir esse elemento, será usado o valor do atributo name da política.
Presença	Opcional
Tipo	String

Elemento <APIKey>

Esse elemento especifica a variável de fluxo que contém a chave de API. Normalmente, o cliente envia a chave de API em um parâmetro de consulta, um cabeçalho HTTP ou um parâmetro de formulário. Por exemplo, se a chave for enviada em um cabeçalho chamado x-apikey, a chave será encontrada na variável: request.header.x-apikey

Padrão	NA
Presença	Obrigatório
Tipo	String

Atributos

A tabela a seguir descreve os atributos do elemento <APIKey>

Atributo	Descrição	Padrão	Presença
ref	Uma referência à variável com a chave de API. Somente um local é permitido por política.	N/A	Obrigatório

Recomenda-se passar a chave de API em um cabeçalho ou parâmetro de formulário em vez de em um parâmetro de consulta. Isso porque os parâmetros de consulta podem aparecer em históricos de navegadores e registros de rede, o que pode representar um risco de segurança.

Exemplos

Nestes exemplos, a chave é transmitida em parâmetros e em um cabeçalho chamado x-apikey.

Como um parâmetro de consulta:

<VerifyAPIKey name="APIKeyVerifier">
    <APIKey ref="request.queryparam.x-apikey"/>
</VerifyAPIKey>

Como um cabeçalho HTTP:

<VerifyAPIKey name="APIKeyVerifier">
    <APIKey ref="request.header.x-apikey"/>
</VerifyAPIKey>

Como um parâmetro de formulário HTTP:

<VerifyAPIKey name="APIKeyVerifier">
    <APIKey ref="request.formparam.x-apikey"/>
</VerifyAPIKey>

Elemento <CacheExpiryInSeconds>

Esse elemento aplica o TTL no cache, o que permite a personalização do período de validade do token de acesso armazenado em cache. O intervalo suportado está entre 1 e 180 segundos. Você pode fornecer uma variável de fluxo e uma variável padrão. Se fornecido, o valor da variável de fluxo terá prioridade sobre o valor padrão especificado.

<CacheExpiryInSeconds ref="request.queryparam.cache_expiry">Value 1</CacheExpiryInSeconds>

Observação: haverá uma queda no desempenho quando o intervalo de armazenamento em cache for reduzido.

Padrão	N/A Se você omitir esse elemento, o período de validade padrão para o token de acesso em cache será de 180 segundos.
Presença	Opcional
Tipo	Inteiro
Valores válidos	Qualquer número inteiro positivo diferente de zero. Especifica o tempo de expiração em segundos.

Atributos

A tabela a seguir descreve os atributos do elemento <CacheExpiryInSeconds>

Atributo	Descrição	Padrão	Presença
ref	Uma referência à variável de fluxo que contém o valor da expiração do cache, expresso em segundos. Se fornecido, o valor da variável de fluxo terá prioridade sobre o valor padrão especificado.	N/A	Opcional

Esquemas

Amostra: veja nossas amostras de repositório do GitHub para os esquemas mais recentes.

Variáveis de fluxo

Quando uma política Verify API Key é aplicada a uma chave de API válida, a Apigee preenche um conjunto de variáveis de fluxo. Essas variáveis estão disponíveis para políticas ou códigos executados posteriormente no fluxo e costumam ser usadas para realizar o processamento personalizado com base nos atributos da chave de API, como o nome do aplicativo, o produto de API usado para autorizar a chave ou atributos personalizados da chave de API.

A política preenche vários tipos diferentes de variáveis de fluxo, incluindo:

• Geral
• App
• Developer
• Analytics
• Monetização

Cada tipo de variável de fluxo tem um prefixo diferente. Todas as variáveis são escalares, exceto aquelas indicadas especificamente como matrizes.

Variáveis gerais de fluxo

A tabela a seguir lista as variáveis gerais de fluxo preenchidas pela política Verify API Key. Todas essas variáveis incluem o prefixo a seguir:

verifyapikey.{policy_name}

Por exemplo: verifyapikey.{policy_name}.client_id

As variáveis disponíveis incluem:

Variável	Descrição
client_id	A chave de cliente (também conhecida como chave de API ou de aplicativo) fornecida pelo aplicativo solicitante.
client_secret	O secret de cliente associado à chave de cliente.
redirection_uris	Qualquer URI de redirecionamento na solicitação
developer.app.id	O ID do desenvolvedor ou aplicativo AppGroup que faz a solicitação. Observação: não use a variável developer.app.id para qualquer uma das finalidades a seguir: identificador da política de cotas Chaves do mapa de chave-valor (KVM, na sigla em inglês) Identificadores enviados para os destinos a serem usados na lógica de negócios de back-end Esse ID é gerado internamente pela Apigee e não tem a garantia de permanecer o mesmo ao longo do tempo. Por exemplo, a Apigee pode alterar o formato ou o comprimento dessa variável.
developer.app.name	O nome do desenvolvedor do app ou do app AppGroup que fez a solicitação.
developer.id	O ID do desenvolvedor ou AppGroup registrado como o proprietário do aplicativo solicitante. Observação: não use a variável developer.id para qualquer uma das finalidades a seguir: Identificador de cota Chaves KVM Identificadores enviados para os destinos a serem usados na lógica de negócios de back-end Esse ID é gerado internamente pela Apigee e não tem a garantia de permanecer o mesmo ao longo do tempo. Por exemplo, a Apigee pode alterar o formato ou o comprimento dessa variável.
developer.{custom_attrib_name}	Todos os atributos personalizados derivados do perfil da chave de aplicativo.
DisplayName	O valor do atributo <DisplayName> da política.
failed	Defina como "true" quando a validação da chave de API falhar.
{custom_app_attrib}	Qualquer atributo personalizado derivado do perfil do aplicativo. Especifique o nome do atributo personalizado.
apiproduct.name*	O nome do produto de API usado para validar a solicitação.
apiproduct.{custom_attrib_name}*	Qualquer atributo personalizado derivado do perfil de produto de API.
apiproduct.developer.quota.limit*	O limite de cota definido no produto de API, se houver.
apiproduct.developer.quota.interval*	O intervalo de cotas definido no produto de API, se houver.
apiproduct.developer.quota.timeunit*	A unidade de tempo da cota definida no produto de API, se houver.
* As variáveis dos produtos de API serão preenchidas automaticamente se os produtos de API estiverem configurados com ambiente, proxies e recursos válidos (derivados de proxy.pathsuffix). Para instruções sobre como configurar produtos de API, consulte Como gerenciar produtos de API.

Variáveis de fluxo de apps

As variáveis de fluxo a seguir com informações sobre o aplicativo são preenchidas pela política. Todas essas variáveis incluem o prefixo a seguir:

verifyapikey.{policy_name}.app

Exemplo:

verifyapikey.{policy_name}.app.name

As variáveis disponíveis incluem:

Variável	Descrição
name	O nome do app.
id	O ID do aplicativo.
accessType	Não utilizado pela Apigee.
callbackUrl	O URL de callback do aplicativo. Normalmente usado apenas para OAuth.
DisplayName	O nome de exibição do aplicativo.
status	O status do aplicativo, como "aprovado" ou "revogado".
apiproducts	Uma matriz com a lista de produtos de API associados ao aplicativo.
appFamily	Qualquer família de aplicativos que contenha o aplicativo ou "padrão".
appParentStatus	O status do pai do aplicativo, como "ativo" ou "inativo"
appType	O tipo de app como "Desenvolvedor".
appParentId	O ID do aplicativo pai.
created_at	O carimbo de data/hora da criação do aplicativo.
created_by	O endereço de e-mail do desenvolvedor que criou o aplicativo.
last_modified_at	A data e a hora em que o aplicativo foi atualizado pela última vez.
last_modified_by	O endereço de e-mail do desenvolvedor que atualizou o aplicativo pela última vez.
{app_custom_attributes}	Qualquer atributo personalizado do aplicativo. Especifique o nome do atributo personalizado.

Variáveis de fluxo do AppGroup

As seguintes variáveis de fluxo que contêm informações sobre os AppGroups são preenchidas pela política. Esses atributos do AppGroup são preenchidos somente se verifyapikey.{policy_name}.app.appType for "AppGroup".

Todas essas variáveis incluem o prefixo a seguir:

verifyapikey.{policy_name}.appgroup

Exemplo:

verifyapikey.{policy_name}.appgroup.name

Observação: se você migrar do Apigee Edge, as variáveis de fluxo da empresa ficarão automaticamente disponíveis no atributo AppGroup correspondente após a migração. Nenhuma alteração é necessária nos pacotes durante a migração.

As variáveis disponíveis incluem:

Variável	Descrição
name	O nome do AppGroup.
id	O ID do AppGroup. Observação: esse ID é gerado internamente pela Apigee e não há garantias de que ele permanecerá o mesmo ao longo do tempo. Não use a variável appgroup.id para qualquer uma das finalidades a seguir: Identificador de cota Chaves KVM Identificadores enviados para os destinos a serem usados na lógica de negócios de back-end
displayName	O nome de exibição do AppGroup.
appOwnerStatus	É o status do proprietário do app: "ativo", "inativo" ou "login_lock".
created_at	O carimbo de data/hora da criação do AppGroup.
created_by	O endereço de e-mail do desenvolvedor que criou o AppGroup.
last_modified_at	O carimbo de data/hora em que o AppGroup foi modificado pela última vez.
last_modified_by	O endereço de e-mail do desenvolvedor que modificou o AppGroup pela última vez.
{appgroup_custom_attributes}	Qualquer atributo personalizado do AppGroup. Especifique o nome do atributo personalizado.

Variáveis de fluxo do desenvolvedor

As variáveis de fluxo a seguir com informações sobre o desenvolvedor são preenchidas pela política. Todas essas variáveis incluem o prefixo a seguir:

verifyapikey.{policy_name}.developer

Exemplo:

verifyapikey.{policy_name}.developer.id

As variáveis disponíveis incluem:

Variável	Descrição
id	Retorna {org_name}@@@{developer_id}
userName	O nome de usuário do desenvolvedor.
firstName	O nome do desenvolvedor.
lastName	O sobrenome do desenvolvedor.
email	O endereço de e-mail do desenvolvedor.
status	O status do desenvolvedor, como "ativo", "inativo" ou "login_lock".
apps	Uma matriz de aplicativos associados ao desenvolvedor.
created_at	A data e a hora da criação do desenvolvedor.
created_by	O endereço de e-mail do usuário que criou o desenvolvedor.
last_modified_at	O carimbo de data/hora em que o desenvolvedor foi modificado pela última vez.
last_modified_by	O endereço de e-mail do usuário que modificou o desenvolvedor.
{developer_custom_attributes}	Qualquer atributo personalizado de desenvolvedor. Especifique o nome do atributo personalizado.

Variáveis do Analytics

As variáveis a seguir são preenchidas automaticamente no Analytics quando uma política Verify API Key é aplicada a uma chave de API válida. Essas variáveis são preenchidas apenas pela política Verify API Key e pelas políticas de OAuth.

As variáveis e os valores podem ser usados como dimensões para criar relatórios do Analytics e ter visibilidade dos padrões de consumo de desenvolvedores e aplicativos.

• apiproduct.name
• developer.app.name
• client_id
• developer.id

Variáveis de fluxo de monetização

Após a autenticação do usuário, a política VerifyAPIKey verifica todos os planos de tarifas publicados para determinar quais estão ativos, se houver, com base nos períodos de ativação e expiração deles. Se um plano de taxas publicado for encontrado, as seguintes variáveis de fluxo são preenchidas:

Variável	Descrição
mint.mintng_is_apiproduct_monetized	true, se o plano de tarifas publicado ativo for encontrado
mint.mintng_rate_plan_id	ID do plano de tarifas.
mint.rateplan_end_time_ms	Período de expiração do plano de taxas. Por exemplo: 1619433556408
mint.rateplan_start_time_ms	Período de ativação do plano de taxas. Por exemplo: 1618433956209

Referência de erros

Esta seção descreve os códigos de falha e as mensagens de erro que são retornadas e as variáveis de falha definidas pela Apigee quando essa política aciona um erro. Essas informações são importantes para saber se você está desenvolvendo regras de falha para lidar com falhas. Para saber mais, consulte O que você precisa saber sobre erros de política e Como lidar com falhas.

Erros de execução

Esses erros podem ocorrer quando a política é executada.

Código de falha	Status HTTP	Causa
keymanagement.service.consumer_key_missing_api_product_association	400	A credencial do aplicativo não tem uma associação do produto da API. Associe o aplicativo da chave a um produto de API. Isso se aplica a todos os tipos de aplicativos, como apps de desenvolvedores e do AppGroup.
keymanagement.service.DeveloperStatusNotActive	401	O desenvolvedor que criou o app Developer que tem a chave de API que você está usando tem um status inativo. Quando o status de um desenvolvedor de apps é definido como inativo, todos os apps Developer criados por ele são desativados. Um usuário administrador com as devidas permissões, como administrador da organização, pode alterar o status do desenvolvedor das seguintes maneiras: API Apigee: Definir o status de desenvolvedor IU da Apigee: em Registrar desenvolvedores de apps, consulte as instruções para desativar (e ativar) um desenvolvedor.
keymanagement.service.invalid_client-app_not_approved	401	O app Developer associado à chave de API foi revogado. Um app revogado não pode acessar nenhum produto de API e não pode invocar qualquer API gerenciada pela Apigee. Um administrador da organização pode alterar o status de um app Developer usando a API Apigee. Consulte Gerar par de chaves ou Atualizar status do app do desenvolvedor.
oauth.v2.FailedToResolveAPIKey	401	A política espera encontrar a chave de API em uma variável especificada no elemento <APIKey> da política. Esse erro ocorre quando a variável esperada não existe (ela não pode ser resolvida).
oauth.v2.InvalidApiKey	401	Uma chave de API foi recebida pela Apigee, mas é inválida. Quando a Apigee procura a chave no banco de dados, ela precisa corresponder exatamente àquela que foi enviada na solicitação. Se a API já funcionou antes, verifique se a chave não foi gerada novamente. Se a chave tiver sido gerada novamente, você verá este erro se tentar usar a chave antiga. Para mais detalhes, consulte Como controlar o acesso às suas APIs registrando aplicativos.
oauth.v2.InvalidApiKeyForGivenResource	401	Uma chave de API foi recebida pela Apigee e é válida; no entanto, ela não corresponde a uma chave aprovada no app Developer associado ao seu proxy de API por meio de um produto.

Observação: atualmente, a Apigee não relata o erro ApiKeyNotApproved com precisão. Em vez disso, se uma chave não for aprovada (o status dela está definido como revoked ou pending), você receberá o erro FailedToResolveAPIKey. Para mais informações e uma possível solução alternativa, consulte Verificar se a chave da API não informa a chave de API não aprovada.

Erros na implantação

Esses erros podem ocorrer quando você implanta um proxy que contém esta política.

Nome do erro	Causa
SpecifyValueOrRefApiKey	O elemento <APIKey> não tem um valor ou uma chave especificada.

Variáveis de falha

Essas variáveis são definidas quando ocorre um erro de tempo de execução. Para mais informações, consulte O que você precisa saber sobre erros de política.

Variáveis	Onde	Exemplo
fault.name="fault_name"	fault_name é o nome da falha, conforme listado na tabela Erros de ambiente de execução acima. O nome da falha é a última parte do código de falha.	fault.name Matches "FailedToResolveAPIKey"
oauthV2.policy_name.failed	policy_name é o nome da política especificada pelo usuário que gerou a falha.	oauthV2.VK-VerifyAPIKey.failed = true

Exemplos de respostas de erros

Observação: para tratamento de erros, a prática recomendada é interceptar a parte errorcode da resposta de erro. Não confie no texto do faultstring, porque ele pode mudar.

{
   "fault":{
      "faultstring":"Invalid ApiKey",
      "detail":{
         "errorcode":"oauth.v2.InvalidApiKey"
      }
   }
}

{
   "fault":{
      "detail":{
         "errorcode":"keymanagement.service.DeveloperStatusNotActive"
      },
      "faultstring":"Developer Status is not Active"
   }
}

Exemplo de regra de falha

<FaultRule name="FailedToResolveAPIKey">
    <Step>
        <Name>AM-FailedToResolveAPIKey</Name>
    </Step>
    <Condition>(fault.name Matches "FailedToResolveAPIKey") </Condition>
</FaultRule>