Podstawowe zasady uwierzytelniania

Wyświetlasz dokumentację Apigee Edge.
Zapoznaj się z dokumentacją Apigee X. info

Co

Umożliwia korzystanie z uproszczonego uwierzytelniania podstawowego w celu zapewnienia bezpieczeństwa na ostatnim etapie. Zasada pobiera nazwę użytkownika i hasło, koduje je w formacie Base64 i zapisuje wynikową wartość w zmiennej. Wynikowa wartość ma format Basic Base64EncodedString. Zwykle zapisujesz tę wartość w nagłówku HTTP, np. w nagłówku Authorization.

Zasada umożliwia też dekodowanie danych logowania przechowywanych w ciągu tekstowym zakodowanym w standardzie Base64 na nazwę użytkownika i hasło.

Przykłady

<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>

Informacje o zasadach uwierzytelniania podstawowego

Zasady te działają w 2 trybach:

• Kodowanie: koduje w formacie Base64 nazwę użytkownika i hasło przechowywane w zmiennych.
• Dekoduj: dekoduje nazwę użytkownika i hasło z ciągu zakodowanego w standardzie Base64.

Nazwa użytkownika i hasło są zwykle przechowywane w pamięci klucz/wartość, a następnie odczytywane z niej w czasie działania programu. Szczegółowe informacje o korzystaniu z pamięci klucz/wartość znajdziesz w zasadach dotyczących operacji na mapie klucz/wartość.

Odwołanie do elementu

Odwołanie do elementu opisuje elementy i atrybuty zasady 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>

Atrybuty <BasicAuthentication>

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

W tej tabeli opisano atrybuty wspólne dla wszystkich elementów nadrzędnych zasad:

&lt;DisplayName&gt; element

Używaj oprócz atrybutu name do oznaczania zasady w edytor proxy interfejsu zarządzania z inną nazwą w języku naturalnym.

<DisplayName>Policy Display Name</DisplayName>

Element <Operation>

Określa, czy zasady kodują lub dekodują dane logowania w formacie Base64.

<Operation>Encode</Operation>

Element <IgnoreUnresolvedVariables>

Jeśli zasada ma wartość true, nie zgłasza błędu, gdy nie można rozpoznać zmiennej. W kontekście zasady BasicAuthentication to ustawienie ma zwykle wartość false, ponieważ zwykle korzystne jest zgłaszanie błędu, jeśli w określonych zmiennych nie można znaleźć nazwy użytkownika ani hasła.

<IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>

Element <User>

• Do kodowania użyj elementu <User>, aby określić zmienną zawierającą nazwę użytkownika. Wartości nazwy użytkownika i hasła są łączone dwukropkiem przed zakodowaniem w formacie Base64.
• W przypadku dekodowania określ zmienną, w której zapisana jest zdekodowana nazwa użytkownika.

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

Atrybuty

Element <Password>

• W przypadku kodowania użyj elementu <Password>, aby określić zmienną zawierającą hasło.
• W przypadku dekodowania określ zmienną, w której zapisane jest zdekodowane hasło.

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

Atrybuty

Element <AssignTo>

W przypadku operacji Encode określa zmienną docelową, która ma zostać ustawiona na wartość zakodowaną wygenerowaną przez te zasady.

Poniższy przykład wskazuje, że zasady powinny ustawić nagłówek Authorization wiadomości na wygenerowaną wartość:

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

Atrybuty

Element <Source>

Do dekodowania użyj zmiennej zawierającej ciąg znaków zakodowany w formacie Base64 w postaci Basic Base64EncodedString. Na przykład określ request.header.Authorization, co odpowiada nagłówkowi Authorization.

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

Zmienne przepływu

Gdy zasada nie działa, ustawiana jest ta zmienna przepływu:

• BasicAuthentication.{policy_name}.failed (o wartości „true”)

Odniesienie do błędu

W tej sekcji opisano kody błędów i komunikaty o błędach, które są zwracane, oraz zmienne błędów ustawiane przez Edge, gdy ta zasada wyzwala błąd. Warto o tym wiedzieć, jeśli rozwijasz reguły błędów, aby obsługi błędów. Więcej informacji znajdziesz w artykule Co musisz wiedzieć o błędach związanych z zasadami i postępowaniu z błędami

Błędy w czasie wykonywania

Te błędy mogą wystąpić podczas wykonywania zasady.

Błędy wdrażania

Te błędy mogą wystąpić podczas wdrażania serwera proxy zawierającego tę zasadę.

Zmienne błędów

Te zmienne są ustawiane po wystąpieniu błędu działania. Więcej informacji znajdziesz w artykule Podstawowe informacje o błędach związanych z naruszeniem zasad.

Przykładowa odpowiedź na błąd

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

Przykładowa reguła błędu

<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>

Schematy

Powiązane artykuły

Zasady dotyczące operacji na mapie par klucz-wartość