นโยบายการตรวจสอบสิทธิ์พื้นฐาน

คุณกำลังดูเอกสารประกอบของ 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>

เกี่ยวกับนโยบายการตรวจสอบสิทธิ์พื้นฐาน

นโยบายนี้มีโหมดการทำงาน 2 โหมด ได้แก่

• เข้ารหัส: 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">

ตารางต่อไปนี้อธิบายแอตทริบิวต์ทั่วไปในองค์ประกอบระดับบนสุดของนโยบายทั้งหมด

&lt;DisplayName&gt; องค์ประกอบ

ใช้เพิ่มเติมจากแอตทริบิวต์ name เพื่อติดป้ายกำกับนโยบายใน เครื่องมือแก้ไขพร็อกซี UI การจัดการด้วยชื่อที่เป็นภาษาธรรมชาติต่างกัน

<DisplayName>Policy Display Name</DisplayName>

องค์ประกอบ <Operation>

กำหนดว่านโยบายจะเข้ารหัสหรือถอดรหัสข้อมูลเข้าสู่ระบบแบบ Base64 หรือไม่

<Operation>Encode</Operation>

องค์ประกอบ <IgnoreUnresolvedVariables>

เมื่อตั้งค่าเป็น true นโยบายจะไม่แสดงข้อผิดพลาดหากแก้ไขตัวแปรไม่ได้ เมื่อใช้ในการตั้งค่านโยบาย BasicAuthentication โดยปกติแล้วการตั้งค่านี้จะตั้งค่าเป็น false เนื่องจากโดยทั่วไปแล้วการแสดงข้อผิดพลาดจะเป็นประโยชน์หากไม่พบชื่อผู้ใช้หรือรหัสผ่านในตัวแปรที่ระบุ

<IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>

องค์ประกอบ <User>

• สำหรับการเข้ารหัส ให้ใช้องค์ประกอบ <User> เพื่อระบุตัวแปร ที่มีชื่อผู้ใช้ ระบบจะต่อค่าชื่อผู้ใช้และรหัสผ่านด้วยเครื่องหมายโคลอนก่อน การเข้ารหัส Base64
• สำหรับการถอดรหัส ให้ระบุตัวแปรที่จะเขียนชื่อผู้ใช้ที่ถอดรหัสแล้ว

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

Attributes

องค์ประกอบ <Password>

• สำหรับการเข้ารหัส ให้ใช้องค์ประกอบ <Password> เพื่อระบุตัวแปร ที่มีรหัสผ่าน
• สำหรับการถอดรหัส ให้ระบุตัวแปรที่จะเขียนรหัสผ่านที่ถอดรหัสแล้ว

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

Attributes

องค์ประกอบ <AssignTo>

สําหรับการดําเนินการ Encode ให้ระบุตัวแปรเป้าหมายที่จะตั้งค่าด้วยค่าที่เข้ารหัส ซึ่งสร้างขึ้นโดยนโยบายนี้

ตัวอย่างต่อไปนี้ระบุว่านโยบายควรตั้งค่าส่วนหัว Authorization ของข้อความเป็นค่าที่สร้างขึ้น

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

Attributes

องค์ประกอบ <Source>

สำหรับการถอดรหัส ตัวแปรที่มีสตริงที่เข้ารหัส Base64 จะอยู่ในรูปแบบ Basic Base64EncodedString เช่น ระบุ request.header.Authorization ที่สอดคล้องกับส่วนหัว Authorization

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

ตัวแปรโฟลว์

ระบบจะตั้งค่าตัวแปรโฟลว์ต่อไปนี้เมื่อนโยบายไม่สำเร็จ

• BasicAuthentication.{policy_name}.failed (มีค่าเป็นจริง)

ข้อมูลอ้างอิงข้อผิดพลาด

ส่วนนี้จะอธิบายรหัสข้อผิดพลาดและข้อความแสดงข้อผิดพลาดที่แสดงกลับมา และตัวแปรข้อผิดพลาดที่ 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