การใช้การตรวจสอบสิทธิ์พื้นฐานเพื่อเข้าถึง Edge API

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

คุณสามารถใช้การตรวจสอบสิทธิ์ขั้นพื้นฐานเพื่อเข้าถึง Edge API สำหรับบัญชี Edge for the Cloud โดยการตรวจสอบสิทธิ์ขั้นพื้นฐาน คุณจะส่งข้อมูลเข้าสู่ระบบ (อีเมลของบัญชี Apigee และรหัสผ่าน) ในคำขอแต่ละรายการไปยัง Edge API

การตรวจสอบสิทธิ์ขั้นพื้นฐานเป็นกลไกการตรวจสอบสิทธิ์ที่ปลอดภัยน้อยที่สุดในกลไกการตรวจสอบสิทธิ์ที่รองรับ เนื่องจากระบบไม่ได้เข้ารหัสหรือแฮชข้อมูลเข้าสู่ระบบ แต่จะเข้ารหัส Base64 เท่านั้น Apigee จึงแนะนำให้คุณใช้ OAuth2 หรือ SAML เพื่อเข้าถึง Edge API แทนการตรวจสอบสิทธิ์ขั้นพื้นฐาน

รูปแบบการตรวจสอบสิทธิ์ขั้นพื้นฐาน

คุณสามารถส่งข้อมูลเข้าสู่ระบบเป็นส่วนหัวที่เข้ารหัส Base64 หรือเป็นพารามิเตอร์ในไคลเอ็นต์ HTTP

เมื่อส่งข้อมูลเข้าสู่ระบบในส่วนหัว คุณต้องเข้ารหัส Base64 ตัวอย่างส่วนหัวการตรวจสอบสิทธิ์ขั้นพื้นฐาน HTTP ที่เข้ารหัสแล้ว

Authorization: Basic YWhhbWlsdG9uQGFwaWdlZS5jb206bXlwYXNzdzByZAo

หากใช้ไคลเอ็นต์ เช่น curl คุณจะส่งข้อมูลเข้าสู่ระบบด้วยตัวเลือก -u ดังที่แสดงในตัวอย่างต่อไปนี้

curl https://api.enterprise.apigee.com/v1/organizations/ahamilton-eval -u email_address:password

curl จะเข้ารหัสอีเมลและรหัสผ่านของคุณ แล้วเพิ่มข้อมูลดังกล่าวลงในส่วนหัว Authorization ของคำขอให้คุณ

หากไม่ใส่รหัสผ่าน ระบบจะแจ้งให้คุณป้อนรหัสผ่าน

โปรดทราบว่าคุณต้องใช้อีเมลของบัญชี Apigee ไม่ใช่ชื่อผู้ใช้ในการเรียก Edge API

เข้าถึง Edge API ด้วย curl

นอกจากนี้ คุณยังตั้งค่าคำขอส่วนหัว Authorization ด้วยตนเองได้เมื่อใช้ curl เพื่อเข้าถึง Edge API

แม้ว่า curl จะเข้ารหัสข้อมูลเข้าสู่ระบบของคุณตามที่ระบุไว้ข้างต้น แต่ในบางกรณี คุณอาจไม่ต้องการป้อนข้อมูลเข้าสู่ระบบที่ไม่ได้เข้ารหัสในประวัติคำสั่ง

วิธีตั้งค่าส่วนหัวด้วยตนเองและเข้าถึง Edge API ด้วย curl:

  1. เข้ารหัส Base64 อีเมลและรหัสผ่านด้วยเครื่องมือ เช่น base64 ตัวอย่าง
      read -es PASS
      echo -n ahamilton@apigee.com:$PASS | base64

    เครื่องมือ base64 จะแสดงสตริงที่เข้ารหัส

    YWhhbWlsdG9uQGFwaWdlZS5jb206bXlwYXNzdzByZAo=
  2. เพิ่มสตริงที่เข้ารหัสลงในส่วนหัว Authorization ในคำขอ Edge API ดังที่แสดงในตัวอย่างต่อไปนี้
        read -es PASS
        BASIC=$(echo -n ahamilton@apigee.com:$PASS | base64
        curl -H "Authorization: Basic $BASIC" \
        https://api.enterprise.apigee.com/v1/organizations/ahamilton-eval
        {
        "createdAt" : 1491854501264,
        "createdBy" : "noreply_iops@apigee.com",
        "displayName" : "ahamilton",
        "environments" : [ "prod", "test" ],
        "lastModifiedAt" : 1491854501264,
        "lastModifiedBy" : "noreply_iops@apigee.com",
        "name" : "ahamilton",
        "properties" : {
        "property" : [ {
        "name" : "features.isSmbOrganization",
        "value" : "false"
        }, {
        "name" : "features.isCpsEnabled",
        "value" : "true"
        } ]
        },
        "type" : "trial"
        }

คำขอนี้จะดึงรายละเอียดเกี่ยวกับองค์กร "ahamilton-eval" ดูรายการปลายทาง Edge API ทั้งหมดได้ที่ ข้อมูลอ้างอิง Apigee Edge API

คุณต้องใส่ส่วนหัว Authorization ในทุกคำขอ

ปิดใช้การตรวจสอบสิทธิ์ขั้นพื้นฐาน

คุณสามารถปิดใช้การตรวจสอบสิทธิ์ขั้นพื้นฐาน (ตราบใดที่เปิดใช้ OAuth2 หรือ SAML อยู่) ได้โดยส่งคำขอไปยัง ทีมสนับสนุนของ Apigee Edge

หลักเกณฑ์การเขียนสคริปต์

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

ปฏิบัติตามหลักเกณฑ์ต่อไปนี้

  1. รวมข้อมูลเข้าสู่ระบบไว้ในไฟล์เดียวที่ใช้เป็นแหล่งที่มาสำหรับโปรแกรมและ สคริปต์ที่คุณเขียน
  2. ปกป้องไฟล์แหล่งที่มาของข้อมูลเข้าสู่ระบบให้ได้มากที่สุดโดยใช้การรักษาความปลอดภัยและ สิทธิ์ของระบบไฟล์
  3. สร้างไคลเอ็นต์การทำงานอัตโนมัติที่มีสิทธิ์จำกัดอย่างมากในทรัพยากรที่เฉพาะเจาะจงใน องค์กร