Mendapatkan kredensial klien

Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X. info

Topik ini menunjukkan cara mendapatkan kredensial klien (juga disebut kunci developer) untuk tujuan pengembangan dan pengujian menggunakan aplikasi dan produk developer siap pakai. Untuk situasi produksi, langkah-langkahnya serupa, tetapi Anda akan menggunakan aplikasi developer, produk, dan entitas lainnya sendiri.

Apa itu kredensial klien?

Untuk berpartisipasi dalam alur OAuth 2.0, semua aplikasi klien harus didaftarkan dengan Apigee Edge (server otorisasi). Saat mendaftarkan aplikasi, Anda akan diberi dua kunci: ID Konsumen dan Consumer Secret. ID Konsumen adalah kunci publik dan Rahasia Konsumen tidak boleh dipublikasikan. Kunci kredensial klien ini memungkinkan Apigee Edge mengidentifikasi aplikasi klien secara unik.

Langkah cepat

Langkah-langkah cepat ini menunjukkan cara mendapatkan kunci developer untuk salah satu aplikasi siap pakai yang dikonfigurasi saat Anda membuat organisasi Apigee Edge. Anda dapat menggunakan kunci ini terutama untuk pengembangan dan pengujian:

  1. Akses halaman Aplikasi Developer, seperti yang dijelaskan di bawah.

    Edge

    Untuk mengakses halaman Aplikasi Developer menggunakan UI Edge:

    1. Login ke apigee.com/edge.
    2. Pilih Publish > Apps di menu navigasi sebelah kiri.
    3. Klik +Proxy

    Classic Edge (Private Cloud)

    Untuk mengakses halaman Aplikasi Developer menggunakan UI Edge Klasik:

    1. Login ke http://ms-ip:9000, dengan ms-ip adalah alamat IP atau nama DNS node Server Pengelolaan.
    2. Pilih Publikasikan > Aplikasi Developer di panel navigasi atas.
  2. Klik Aplikasi Cuaca untuk membuka halaman ringkasan Aplikasi Cuaca. Perhatikan bahwa developer yang terkait dengan aplikasi adalah Nicolai Tesla. Aplikasi dan developer ini disediakan secara default saat organisasi Anda dibuat. Semua aplikasi developer harus memiliki developer yang terkait dengannya.
  3. Di bagian Products, di samping produk Premium Weather API, klik Show untuk menampilkan nilai Consumer ID dan Consumer Secret.
  4. Salin dan simpan kedua nilai tersebut -- Anda akan perlu menggunakannya nanti untuk melakukan panggilan API guna mendapatkan token akses.

Mendapatkan kredensial klien dengan Edge API

Anda juga dapat memperoleh secret dan kunci pengguna untuk aplikasi dengan memanggil API pengelolaan. Pertama, dapatkan daftar aplikasi di organisasi Anda dengan melakukan panggilan API berikut:

$ curl https://api.enterprise.apigee.com/v1/o/{org_name}/apps \
-u email:password

Panggilan ini menampilkan daftar aplikasi menurut ID aplikasi.

[ "da496fae-2a04-4a5c-b2d0-709278a6f9db", "50e3e831-175b-4a05-8fb6-05a54701af6e" ]

Anda dapat mengambil profil aplikasi dengan melakukan panggilan GET sederhana di ID aplikasi:

$ curl https://api.enterprise.apigee.com/v1/o/{org_name}/apps/{app_id} \
-u email:password

Contoh:

$ curl https://api.enterprise.apigee.com/v1/o/{org_name}/apps/da496fae-2a04-4a5c-b2d0-709278a6f9db \
-u email:password

Panggilan API menampilkan profil aplikasi yang Anda tentukan. Misalnya, profil aplikasi untuk weatherapp memiliki representasi JSON berikut:

{
  "accessType" : "read",
  "apiProducts" : [ ],
  "appFamily" : "default",
  "appId" : "da496fae-2a04-4a5c-b2d0-70928a6f9db",
  "attributes" : [ ],
  "callbackUrl" : "http://weatherapp.com",
  "createdAt" : 1380290158713,
  "createdBy" : "noreply_admin@apigee.com",
  "credentials" : [ {
    "apiProducts" : [ {
      "apiproduct" : "PremiumWeatherAPI",
      "status" : "approved"
    } ],
    "attributes" : [ ],
    "consumerKey" : "bBGAQrXgivA9lKu7NMPyYpVKNhGar6K",
    "consumerSecret" : "hAr4Gn0gA9vyvI4",
    "expiresAt" : -1,
    "issuedAt" : 1380290161417,
    "scopes" : [ ],
    "status" : "approved"
  } ],
  "developerId" : "5w95xGkpnjzDBT4",
  "lastModifiedAt" : 1380290158713,
  "lastModifiedBy" : "noreply_admin@apigee.com",
  "name" : "weatherapp",
  "scopes" : [ ],
  "status" : "approved"
}

Catat nilai untuk consumerKey dan consumerSecret.

Pembahasan mendalam

Untuk pembahasan yang lebih mendetail tentang pendaftaran aplikasi dan pengelolaan kunci, lihat Mendaftarkan aplikasi dan mengelola kunci API.