استفاده از «اصالت‌سنجی پایه» برای دسترسی به Edge API

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید. اطلاعات

می‌توانید از «اصالت‌سنجی پایه» برای دسترسی به Edge API برای حساب Edge for the Cloud خود استفاده کنید. با «اصالت‌سنجی پایه»، اطلاعات اعتباری خود (نشانی ایمیل حساب Apigee و گذرواژه) را در هر درخواست به Edge API ارسال می‌کنید.

«اصالت‌سنجی پایه» ناامن‌ترین سازوکار اصالت‌سنجی پشتیبانی‌شده است. اعتبارنامه‌های شما رمزگذاری یا درهم‌سازی نشده است؛ فقط با Base64 کدبندی شده است. به‌جای «اصالت‌سنجی پایه»، Apigee توصیه می‌کند برای دسترسی به Edge API از OAuth2 یا SAML استفاده کنید.

قالب «اصالت‌سنجی پایه»

می‌توانید اطلاعات اعتباری خود را به‌عنوان سرصفحه کدبندی‌شده 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 را در هر درخواست بگنجانید.

غیرفعال کردن اصالت‌سنجی پایه

با ارسال درخواست به پشتیبانی Apigee Edge می‌توانید «احراز هویت پایه» را غیرفعال کنید (به‌شرطی که OAuth2 یا SAML فعال باشد).

رهنمودهای دستورگان‌نویسی

در برخی‌از موقعیت‌ها، جمع‌آوری گذرواژه هنگام اجرای دستورگان عملی نیست. برای مثال، ممکن است لازم باشد کار cron را اجرا کنید که وقتی هیچ سرپرستی حضور ندارد فعال می‌شود. در این موقعیت‌ها، باید گذرواژه را بدون دخالت انسان دراختیار دستورگان قرار دهید.

این دستورالعمل‌ها را دنبال کنید:

  1. اطلاعات اعتباری را در یک فایل واحد که به‌عنوان منبع برنامه‌ها و دستورگان‌هایی که می‌نویسید استفاده می‌شود متمرکز کنید
  2. تا حد امکان بااستفاده از امنیت سیستم فایل و اجازه‌ها از فایل منبع اطلاعات اعتباری محافظت کنید
  3. کارخواه خودکارسازی با اجازه‌های بسیار محدود در منابع خاص در سازمانتان ایجاد کنید.