Базовая политика аутентификации

Вы просматриваете документацию Apigee Edge .
Перейти к документации Apigee X. info

Что

Позволяет использовать облегченную базовую аутентификацию для обеспечения безопасности последней мили. Политика принимает имя пользователя и пароль, кодирует их в Base64 и записывает полученное значение в переменную. Результирующее значение имеет вид Basic Base64EncodedString . Обычно это значение записывается в HTTP-заголовок, например, в заголовок Authorization .

Политика также позволяет декодировать учетные данные, хранящиеся в строке, закодированной в Base64, в имя пользователя и пароль.

Образцы

<BasicAuthentication name="ApplyBasicAuthHeader">
   <DisplayName>ApplyBasicAuthHeader</DisplayName>
   <Operation>Encode</Operation>
   <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
   <User ref="BasicAuth.credentials.username" />
   <Password ref="BasicAuth.credentials.password" />
   <AssignTo createNew="false">request.header.Authorization</AssignTo>
</BasicAuthentication>

{
  "encrypted" : true,
  "entry" : [ {
    "name" : "username",
    "value" : "MyUsername"
  }, {
    "name" : "password",
    "value" : "MyPassword"
  } ],
  "name" : "BasicAuthCredentials"
}
      

<KeyValueMapOperations name="getCredentials" mapIdentifier="BasicAuthCredentials">
  <Scope>apiproxy</Scope>
  <Get assignTo="credentials.username" index='1'>
    <Key>
      <Parameter>username</Parameter>
    </Key>
  </Get>
  <Get assignTo="credentials.password" index='1'>
    <Key>
      <Parameter>password</Parameter>
    </Key>
  </Get>
</KeyValueMapOperations>
      

<BasicAuthentication name="DecodeBaseAuthHeaders">
   <DisplayName>Decode Basic Authentication Header</DisplayName>
   <Operation>Decode</Operation>
   <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
   <User ref="request.header.username" />
   <Password ref="request.header.password" />
   <Source>request.header.Authorization</Source>
</BasicAuthentication>

О политике базовой аутентификации

Политика имеет два режима работы:

• Кодирование : Base64 кодирует имя пользователя и пароль, хранящиеся в переменных.
• Декодирование : декодирует имя пользователя и пароль из строки, закодированной в формате Base64.

Имя пользователя и пароль обычно хранятся в хранилище ключей/значений, а затем считываются из него во время выполнения. Подробнее об использовании хранилища ключей/значений см. в разделе «Политика операций с картой ключей и значений» .

Ссылка на элемент

Ссылка на элемент описывает элементы и атрибуты политики BasicAuthentication.

<BasicAuthentication async="false" continueOnError="false" enabled="true" name="Basic-Authentication-1">
   <DisplayName>Basic Authentication 1</DisplayName>
   <Operation>Encode</Operation>
   <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
   <User ref="request.queryparam.username" />
   <Password ref="request.queryparam.password" />
   <AssignTo createNew="false">request.header.Authorization</AssignTo>
   <Source>request.header.Authorization</Source> 
</BasicAuthentication>

Атрибуты <BasicAuthentication>

<BasicAuthentication async="false" continueOnError="false" enabled="true" name="Basic-Authentication-1">

The following table describes attributes that are common to all policy parent elements:

<DisplayName> element

Use in addition to the name attribute to label the policy in the management UI proxy editor with a different, natural-language name.

<DisplayName>Policy Display Name</DisplayName>

Элемент <Операция>

Определяет, будет ли политика Base64 кодировать или декодировать учетные данные.

<Operation>Encode</Operation>

Элемент <IgnoreUnresolvedVariables>

Если задано значение true , политика не будет выдавать ошибку, если переменная не может быть разрешена. При использовании в контексте политики BasicAuthentication этот параметр обычно имеет значение false поскольку обычно полезно выдавать ошибку, если имя пользователя или пароль не могут быть найдены в указанных переменных.

<IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>

Элемент <Пользователь>

• Для кодирования используйте элемент <User> , чтобы указать переменную, содержащую имя пользователя. Значения имени пользователя и пароля объединяются двоеточием перед кодированием в Base64.
• Для декодирования укажите переменную, в которой записано декодированное имя пользователя.

<User ref="request.queryparam.username" /> 

Атрибуты

Элемент <Пароль>

• Для кодирования используйте элемент <Password> , чтобы указать переменную, содержащую пароль.
• Для декодирования укажите переменную, в которую записан декодированный пароль.

<Password ref="request.queryparam.password" />

Атрибуты

Элемент <AssignTo>

Для операции Encode указывает целевую переменную, которую необходимо задать с помощью кодированного значения, созданного этой политикой.

В следующем примере показано, что политика должна установить заголовок Authorization сообщения на сгенерированное значение:

<AssignTo createNew="false">request.header.Authorization</AssignTo>

Атрибуты

Элемент <Источник>

Для декодирования используется переменная, содержащая строку в кодировке Base64 в формате Basic Base64EncodedString . Например, укажите request.header.Authorization , что соответствует заголовку Authorization .

<Source>request.header.Authorization</Source>

Переменные потока

Следующая переменная потока устанавливается, когда политика не выполняется:

• BasicAuthentication.{policy_name}.failed (со значением true)

Ссылка на ошибку

В этом разделе описаны коды ошибок и сообщения об ошибках, которые возвращаются, а также переменные ошибок, которые устанавливаются Edge, когда эта политика вызывает ошибку. Эту информацию важно знать, если вы разрабатываете правила обработки ошибок. Дополнительные сведения см. в разделах Что нужно знать об ошибках политики и Обработка ошибок .

Ошибки выполнения

Эти ошибки могут возникать при выполнении политики.

Ошибки развертывания

Эти ошибки могут возникнуть при развертывании прокси-сервера, содержащего эту политику.

Переменные неисправности

Эти переменные устанавливаются при возникновении ошибки во время выполнения. Дополнительные сведения см. в разделе Что нужно знать об ошибках политики .

Пример ответа об ошибке

{  
   "fault":{  
      "detail":{  
         "errorcode":"steps.basicauthentication.UnresolvedVariable"
      },
      "faultstring":"Unresolved variable : request.queryparam.password"
   }
}

Пример правила неисправности

<FaultRule name="Basic Authentication Faults">
    <Step>
        <Name>AM-UnresolvedVariable</Name>
        <Condition>(fault.name Matches "UnresolvedVariable") </Condition>
    </Step>
    <Step>
        <Name>AM-AuthFailedResponse</Name>
        <Condition>(fault.name = "InvalidBasicAuthenticationSource")</Condition>
    </Step>
    <Condition>(BasicAuthentication.BA-Authentication.failed = true) </Condition>
</FaultRule>

Схемы

Похожие темы

Политика операций Key Value Map