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

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่ เอกสารประกอบของ Apigee X info

อะไร

ช่วยให้คุณใช้ การตรวจสอบสิทธิ์พื้นฐานแบบ Lightweight เพื่อ ความปลอดภัยในระยะสุดท้ายได้ นโยบายจะใช้ชื่อผู้ใช้และรหัสผ่าน เข้ารหัส Base64 และเขียนค่าที่ได้ลงในตัวแปร ค่าที่ได้จะอยู่ในรูปแบบ Basic Base64EncodedString โดยปกติแล้ว คุณจะเขียนค่านี้ลงในส่วนหัว HTTP เช่น ส่วนหัวการให้สิทธิ์

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

ตัวอย่าง

<BasicAuthentication name="ApplyBasicAuthHeader">
   <DisplayName>ApplyBasicAuthHeader</DisplayName>
   <Operation>Encode</Operation>
   <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
   <User ref="credentials.username" />
   <Password ref="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 async="false" continueOnError="false" enabled="true" name="Basic-Authentication-1">
   <DisplayName>Basic Authentication 1</DisplayName>
   <Operation>Encode</Operation>
   <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
   <User ref="credentials.username" />
   <Password ref="credentials.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 นโยบายจะไม่แสดงข้อผิดพลาดหากไม่สามารถแก้ปัญหาตัวแปรได้ เมื่อใช้ในบริบทของนโยบายการตรวจสอบสิทธิ์พื้นฐาน โดยปกติแล้วการตั้งค่านี้จะตั้งค่า เป็น false เนื่องจากโดยทั่วไปแล้วการแสดงข้อผิดพลาดหากไม่พบชื่อผู้ใช้หรือ รหัสผ่านในตัวแปรที่ระบุจะเป็นประโยชน์

<IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>

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

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

<User ref="credentials.username" /> 

แอตทริบิวต์

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

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

<Password ref="credentials.password" />

แอตทริบิวต์

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

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

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

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

แอตทริบิวต์

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

สำหรับการถอดรหัส ให้ระบุตัวแปรที่มีสตริงที่เข้ารหัส Base64 ในรูปแบบที่ เป็น Basic Base64EncodedString เช่น ระบุ request.header.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>

สคีมา

หัวข้อที่เกี่ยวข้อง

นโยบายการดำเนินการ แผนที่คีย์/ค่า