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

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

อะไร

ช่วยให้คุณสามารถใช้การตรวจสอบสิทธิ์พื้นฐานขนาดเล็กสำหรับ การรักษาความปลอดภัยแบบสุดท้าย นโยบายนี้จะใช้ชื่อผู้ใช้และรหัสผ่าน 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">

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

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

ใช้เพิ่มเติมจากแอตทริบิวต์ 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> องค์ประกอบ

ระบุตัวแปรเป้าหมายที่จะตั้งค่าด้วยค่าที่เข้ารหัสหรือถอดรหัสซึ่งค่านี้สร้างขึ้น

ตัวอย่างต่อไปนี้ระบุว่านโยบายควรตั้งค่า 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>

สคีมา

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

แมปค่าคีย์ นโยบายการดำเนินการ