Memperoleh 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 yang siap pakai. Untuk situasi produksi, langkah-langkahnya sama, tetapi Anda akan menggunakan aplikasi developer, produk, dan entitas lainnya milik Anda sendiri.

Apa yang dimaksud dengan kredensial klien?

Untuk berpartisipasi dalam alur OAuth 2.0, semua aplikasi klien harus terdaftar di Apigee Edge (server otorisasi). Saat mendaftarkan aplikasi, Anda akan diberi dua kunci: Consumer ID 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 Edge UI:

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

    Edge Klasik (Private Cloud)

    Untuk mengakses halaman Aplikasi Developer menggunakan UI Klasik Edge:

    1. Login ke http://ms-ip:9000, dengan ms-ip yang merupakan alamat IP atau nama DNS node Server Pengelolaan.
    2. Pilih Publikasikan > Aplikasi Developer di menu navigasi atas.
  2. Klik Aplikasi Cuaca untuk membuka halaman ringkasan Aplikasi Cuaca. Perhatikan bahwa developer yang terkait dengan aplikasi ini 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 Produk, di samping produk Premium Weather API, klik Tampilkan untuk menampilkan nilai ID Konsumen dan Rahasia Konsumen.
  4. Salin dan simpan kedua nilai tersebut. Anda harus menggunakannya nanti untuk melakukan panggilan API guna mendapatkan token akses.

Mendapatkan kredensial klien dengan Edge API

Anda juga bisa mendapatkan kunci dan rahasia konsumen 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 berdasarkan 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 lebih mendalam

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