اتصال API gateway به API Catalog در Postman

Cloud connectorها به تیم‌ها کمک می‌کنند APIهای موجود در API gateway را وارد API Catalog کنند. بعد از اتصال، specificationهای API همراه با metadata مثل environmentها و clusterهای مرتبط در catalog نمایش داده می‌شوند و collectionهایی برای ادامه توسعه API در Postman ساخته می‌شود.

این قابلیت برای پلن‌های Enterprise است و فقط Team Adminها می‌توانند appها را نصب کنند. بعد از اینکه Admin اتصال را کامل کرد، اعضای تیم می‌توانند از تب Service Discovery APIهای gateway را وارد catalog کنند.

Gatewayهای پشتیبانی‌شده #

• AWS
• Google Cloud
• Azure
• IBM API Connect

چه داده‌هایی از gateway دریافت می‌شود؟ #

• id
• name
• version
• title
• description
• openAPI spec
• environment شامل id، name و version

مراحل شروع #

1. وارد API Catalog شوید و Service discovery را انتخاب کنید.
2. بخش Cloud Connectors را باز کنید.
3. connector مورد نظر را انتخاب کنید.
4. داده‌های لازم برای اتصال را وارد کنید. این داده‌ها به نوع connector بستگی دارد.
5. دستورالعمل اتصال را کامل کنید. بعد از اتصال، API Catalog به صورت خودکار APIها را کشف و اضافه می‌کند.

نیازمندی‌های AWS #

• Access key: در AWS IAM Console، مسیر IAM > Users > Security credentials.
• Secret key: همان بخش Security credentials.
• AWS session token: در بخش individual values.
• SSO Region: منطقه‌ای که AWS Gateway در آن deploy شده است.

نیازمندی‌های Google Cloud #

• Project ID: از فایل JSON key مربوط به Service Account.
• Private key ID: از همان فایل JSON.
• Private key: از همان فایل JSON.
• Client email: از همان فایل JSON.
• Client ID: از همان فایل JSON.

نیازمندی‌های Azure #

• Client ID: در Azure Active Directory، بخش App registrations و تب Overview.
• Tenant ID: در همان مسیر Overview.
• Client secret: در بخش Certificates & secrets.
• Subscription ID: در تب Overview.

نیازمندی‌های IBM API Connect #

• API key: از بخش My API Keys در پروفایل IBM API Connect.
• Client ID: از نمونه REST API / curl.
• Client secret: از همان نمونه REST API / curl.

منبع آموزشی: Postman Docs، بازنویسی و ساده‌سازی‌شده برای کاربران فارسی‌زبان.