Fehlerbehebung bei der Bereitstellung von BasicAuthentication-Richtlinien

Sie lesen gerade die Dokumentation zu Apigee und Apigee Hybrid.
Apigee Edge-Dokumentation aufrufen.

War unser Playbook zur Fehlerbehebung hilfreich? Teilen Sie uns dies durch Klicken auf Feedback geben mit.

UserNameRequired

Fehlermeldung

Die Bereitstellung des API-Proxys über die Apigee-Benutzeroberfläche oder die API schlägt mit der folgenden Fehlermeldung fehl:

Error Deploying Revision revision_number to env_name
BasicAuthenticationPolicy: Username element must be present for operation operation.

Beispiel für Fehlermeldung

Error Deploying Revision 2 to test
BasicAuthenticationPolicy: Username element must be present for Encode operation.

Beispiel-Screenshot

Ursache

Die Bereitstellung des API-Proxys schlägt fehl, wenn das <User>-Element nicht in der BasicAuthentication-Richtlinie definiert ist. Das <User>-Element ist für Codierungs- und Decodierungsvorgänge obligatorisch.

Beim Codierungsvorgang wird das <User>-Element verwendet, um die Variable anzugeben, in der der Nutzername enthalten ist. Bei der Decodierung wird das <User>-Element verwendet, um die Variable anzugeben, in die der decodierte Nutzername geschrieben wird.

Diagnose

1. Prüfen Sie alle BasicAuthentication-Richtlinien, die im API-Proxy verwendet werden. Wenn es eine Richtlinie gibt, in der das <User>-Element nicht angegeben ist, ist dies die Ursache des Fehlers. Das <User>-Element ist in der BasicAuthentication-Richtlinie für Codierungs- oder Decodierungsvorgänge erforderlich.

   Die folgende BasicAuthentication-Beispielrichtlinie wird zum Codieren verwendet, das Element <User> ist aber nicht definiert:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <BasicAuthentication name="ApplyBasicAuthHeader">
     <DisplayName>ApplyBasicAuthHeader</DisplayName>
     <Operation>Encode</Operation>
     <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
     <Password ref="BasicAuth.credentials.password"/>
     <AssignTo createNew="false">request.header.Authorization</AssignTo>
   </BasicAuthentication>
   

   Die Bereitstellung schlägt mit folgendem Fehler fehl:

   BasicAuthenticationPolicy: Username element must be present for Encode operation.
   

Lösung

Achten Sie darauf, dass das Element <User> in der BasicAuthentication-Richtlinie für den Codierungs- oder Decodierungsvorgang definiert ist.

Fügen Sie das User>-Element innerhalb der Richtlinie wie unten dargestellt hinzu, um das obige Beispiel zu korrigieren:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<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>

PasswordRequired

Fehlermeldung

Die Bereitstellung des API-Proxys über die Apigee-Benutzeroberfläche oder die API schlägt mit der folgenden Fehlermeldung fehl:

Error Deploying Revision revision_number to env_name
BasicAuthenticationPolicy: Password element must be present for operation operation.

Beispiel für Fehlermeldung

Error Deploying Revision 2 to test
BasicAuthenticationPolicy: Password element must be present for Encode operation.

Beispiel-Screenshot

Ursache

Die Bereitstellung des API-Proxys schlägt fehl, wenn das <Password>-Element nicht in der BasicAuthentication-Richtlinie definiert ist. Das <Password>-Element ist für Codierungs- und Decodierungsvorgänge obligatorisch.

Beim Codierungsvorgang wird das <Password>-Element verwendet, um die Variable anzugeben, in der das Passwort enthalten ist. Bei der Decodierung wird das <Password>-Element verwendet, um die Variable anzugeben, in die das codierte Passwort geschrieben wird.

Diagnose

1. Prüfen Sie alle BasicAuthentication-Richtlinien, die im API-Proxy verwendet werden. Wenn es eine Richtlinie gibt, in der das Element <Password> nicht definiert ist, ist dies die Ursache des Fehlers. Das Element <Password> ist in der BasicAuthentication-Richtlinie für Codierungs- oder Decodierungsvorgänge obligatorisch.

   Die folgende BasicAuthentication-Beispielrichtlinie wird zum Codieren verwendet, das Element <Password> ist aber nicht definiert:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <BasicAuthentication name="ApplyBasicAuthHeader">
     <DisplayName>ApplyBasicAuthHeader</DisplayName>
     <Operation>Encode</Operation>
     <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
     <User ref="BasicAuth.credentials.username"/>
     <AssignTo createNew="false">request.header.Authorization</AssignTo>
   </BasicAuthentication>
   

   Die Bereitstellung schlägt mit folgendem Fehler fehl:

   BasicAuthenticationPolicy: Password element must be present for Encode operation.
   

Lösung

Achten Sie darauf, dass das Element <Password> in der BasicAuthentication-Richtlinie für den Codierungs- oder Decodierungsvorgang definiert ist.

Fügen Sie das Password>-Element innerhalb der Richtlinie wie unten dargestellt hinzu, um das obige Beispiel zu korrigieren:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<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>

AssignToRequired

Fehlermeldung

Die Bereitstellung des API-Proxys über die Apigee-Benutzeroberfläche oder die API schlägt mit der folgenden Fehlermeldung fehl:

Error Deploying Revision revision_number to env_name
BasicAuthenticationPolicy: AssignTo element must be present for operation operation.

Beispiel für Fehlermeldung

Error Deploying Revision 2 to test
BasicAuthenticationPolicy: AssignTo element must be present for Encode operation.

Beispiel-Screenshot

Ursache

Die Bereitstellung des API-Proxys schlägt fehl, wenn das <AssignTo>-Element nicht in der BasicAuthentication-Richtlinie definiert ist. Das <AssignTo>-Element ist für Codierungs- und Decodierungsvorgänge obligatorisch.

Das <AssignTo>-Element gibt die Zielvariable an, die auf den codierten oder decodierten Wert gesetzt werden soll, der von der BasicAuthentication-Richtlinie generiert wird.

Diagnose

1. Prüfen Sie alle BasicAuthentication-Richtlinien, die im API-Proxy verwendet werden. Wenn eine Richtlinie nicht vorhanden ist, in der das Element <AssignTo> nicht definiert ist, ist dies die Ursache des Fehlers. Das Element <AssignTo> ist sowohl für Codierungs- als auch für Decodierungsvorgänge in der BasicAuthentication-Richtlinie definiert.

   Die folgende BasicAuthentication-Beispielrichtlinie wird zum Codieren verwendet, das Element <AssignTo> ist aber nicht definiert:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <BasicAuthentication name="ApplyBasicAuthHeader">
     <DisplayName>ApplyBasicAuthHeader</DisplayName>
     <Operation>Encode</Operation>
     <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
     <User ref="BasicAuth.credentials.username"/>
     <Password ref="BasicAuth.credentials.password"/>
   </BasicAuthentication>
   

   Die Bereitstellung schlägt mit folgendem Fehler fehl:

   BasicAuthenticationPolicy: AssignTo element must be present for Encode operation.
   

Lösung

Achten Sie darauf, dass das Element <AssignTo> in der BasicAuthentication-Richtlinie für den Codierungs- oder Decodierungsvorgang definiert ist.

Fügen Sie das AssignTo>-Element innerhalb der Richtlinie wie unten dargestellt hinzu, um das obige Beispiel zu korrigieren:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<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>

SourceRequired

Fehlermeldung

Die Bereitstellung des API-Proxys über die Apigee-Benutzeroberfläche oder die API schlägt mit der folgenden Fehlermeldung fehl:

Error Deploying Revision revision_number to env_name
BasicAuthenticationPolicy: Source element must be present for Decode operation.

Beispiel für Fehlermeldung

Error Deploying Revision 2 to test
BasicAuthenticationPolicy: Source element must be present for Decode operation.

Beispiel-Screenshot

Ursache

Die Bereitstellung des API-Proxys schlägt fehl, wenn das <Source>-Element nicht in der BasicAuthentication-Richtlinie definiert ist, die für die Decodierung verwendet wird. Das <Source>-Element ist obligatorisch, wenn <Operation> in der BasicAuthentication-Richtlinie als Decode angegeben ist.

Das <Source>-Element gibt den Base64-codierten String an, der decodiert werden soll.

Diagnose

1. Prüfen Sie alle BasicAuthentication-Richtlinien, die im API-Proxy verwendet werden. Wenn es eine Richtlinie gibt, in der das <Source>-Element nicht definiert ist und das <Operation>-Element als Decode definiert ist, ist dies die Fehlerursache. Das <Source>-Element ist obligatorisch, wenn <Operation> in der BasicAuthentication-Richtlinie als Decode angegeben ist.

   Die folgende BasicAuthentication-Beispielrichtlinie wird für den Vorgang Decode verwendet, aber das Element <Source> ist nicht definiert:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <BasicAuthentication name="ApplyBasicAuthHeader">
     <DisplayName>ApplyBasicAuthHeader</DisplayName>
     <Operation>Decode</Operation>
     <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
     <User ref="BasicAuth.credentials.username"/>
     <Password ref="BasicAuth.credentials.password"/>
     <AssignTo createNew="false">request.header.Authorization</AssignTo>
   </BasicAuthentication>
   

   Die Bereitstellung schlägt mit folgendem Fehler fehl:

   BasicAuthenticationPolicy: Source element must be present for Decode operation.
   

Lösung

Achten Sie darauf, dass das <Source>-Element in der BasicAuthentication-Richtlinie definiert ist, wenn es für den Decode-Vorgang verwendet wird.

Fügen Sie das Source>-Element innerhalb der Richtlinie wie unten dargestellt hinzu, um das obige Beispiel zu korrigieren:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BasicAuthentication name="ApplyBasicAuthHeader">
    <DisplayName>ApplyBasicAuthHeader</DisplayName>
    <Operation>Decode</Operation>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <User ref="BasicAuth.credentials.username"/>
    <Password ref="BasicAuth.credentials.password"/>
    <AssignTo createNew="false">request.header.Authorization</AssignTo>
    <Source>request.header.Authorization</Source>
</BasicAuthentication>