Mendaftarkan developer aplikasi

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Daftarkan dan kelola developer aplikasi Anda, seperti yang dijelaskan di bagian berikut. (Pendaftaran aplikasi adalah proses terpisah, seperti yang dijelaskan dalam Mengontrol akses ke API Anda dengan mendaftarkan aplikasi).

Pengantar

Apigee memberikan banyak manfaat yang sepenuhnya bergantung pada mengetahui siapa yang memanggil API Anda. Misalnya, keamanan API, pengelolaan traffic, dan sejumlah besar data analisis bergantung pada mengetahui siapa yang melakukan panggilan. Lalu, bagaimana cara Apigee mengetahui siapa yang memanggil API Anda? Dengan membaca informasi unik di setiap panggilan API, seperti ID pengguna, kunci API, atau token OAuth. Informasi unik tersebut mengunci atau membuka kunci fungsi yang Anda build ke dalam proxy API, sehingga memberi Anda kontrol penuh atas akses dan perilaku API.

Itulah sebabnya developer aplikasi perlu mendaftar untuk menggunakan API Anda. Setelah ditambahkan, developer akan mendaftarkan aplikasi mereka, memilih API yang ingin digunakan, dan menerima kredensial API unik (kunci konsumen dan rahasia) yang diperlukan untuk mengakses API Anda.

Peringatan: Keamanan API, pengelolaan traffic, dan analisis developer/aplikasi bergantung pada konfigurasi proxy API yang tepat. Misalnya, Anda perlu menambahkan kebijakan yang tepat ke proxy, seperti validasi kunci API atau verifikasi token akses OAuth, penerapan kuota, dan pembatasan kapasitas. Kebijakan tersebut mengidentifikasi developer dan aplikasi tertentu yang melakukan panggilan, yang pada akhirnya memungkinkan penegakan keamanan API, pengelolaan traffic khusus developer atau aplikasi, pengambilan analisis API, dan fungsi lainnya. Secara teknis, Anda dapat mengembangkan API terbuka yang tidak memeriksa kunci API atau token akses, yang berarti Anda tidak perlu mendaftarkan developer. Namun, kami sangat tidak menyarankan hal ini, karena Anda akan kehilangan keamanan API, kehilangan kontrol atas performa (melalui pengelolaan traffic yang baik), kehilangan data analisis, dan kehilangan manfaat utama lainnya yang disediakan Apigee.

Cara mendaftarkan developer aplikasi

Daftarkan developer aplikasi menggunakan salah satu metode berikut:

• Jika Anda memiliki akun Apigee berbayar, developer dapat mendaftar sendiri melalui portal developer. Untuk informasi selengkapnya, lihat salah satu bagian berikut berdasarkan jenis portal developer:
  • Portal terintegrasi: Membuat akun pengguna di portal terintegrasi
  • Drupal 10: Mendaftarkan developer aplikasi
• Administrator dapat mendaftarkan developer aplikasi menggunakan API.
• Sebagai administrator portal developer, kelola developer secara langsung di portal Anda, seperti yang dijelaskan di bagian berikut:
  • Portal terintegrasi: Mengelola pengguna untuk mengelola akun pengguna.
    Catatan: Setelah pengguna membuat aplikasi di portal terintegrasi, seperti yang dijelaskan di bagian ini, informasi akun pengguna akan disinkronkan ke dan tersedia di Apigee di halaman Developer. Kumpulan data developer aplikasi dikaitkan dengan akun menggunakan alamat email pengguna. Untuk informasi selengkapnya tentang tempat penyimpanan informasi akun dan aplikasi terkait, lihat Tempat penyimpanan informasi akun developer aplikasi.
  • Drupal 10: Memahami cara developer aplikasi berinteraksi dengan modul Apigee Edge
• Sebagai administrator organisasi, kelola developer menggunakan UI atau API Apigee, seperti yang dijelaskan di bagian berikut.

Catatan: Saat pengguna portal membuat tim di portal terintegrasi, informasi tim developer disimpan di Apigee dan alamat email unik yang dibuat otomatis akan dibuat untuk berfungsi sebagai kunci utama yang digunakan oleh Apigee untuk mengidentifikasi tim developer. Untuk mengetahui informasi selengkapnya, lihat Tempat informasi tim developer disimpan (beta).

Rekomendasi untuk mengelola akun pengguna di portal developer

Apigee merekomendasikan agar Anda mengelola akun pengguna secara langsung di portal developer.

Jika Anda menggunakan portal terintegrasi, ini adalah satu-satunya cara untuk memastikan akun pengguna di portal terintegrasi dan Apigee tetap sinkron.

Jika Anda menggunakan portal developer berbasis Drupal, mengelola akun pengguna langsung di portal developer akan memberikan keuntungan berikut:

• Saat menambahkan developer melalui antarmuka administrator di portal, Anda dapat menetapkan sandi developer untuk portal dan memicu pesan email otomatis yang dikirim ke developer.

  Saat menambahkan atau mengubah developer menggunakan Apigee, tidak ada email yang dikirim ke developer dan Anda tidak dapat menetapkan sandi untuk developer di portal. Oleh karena itu, developer harus mereset sandinya di portal sebelum dapat login ke portal.

• Setiap perubahan yang dilakukan pada akun developer di portal akan otomatis dikirim ke Apigee.

Jika memutuskan untuk mengelola akun pengguna berbasis Drupal menggunakan Apigee, Anda harus menyinkronkan developer aplikasi antara portal dan Apigee.

Menjelajahi halaman Developer

Akses dan jelajahi halaman Developer menggunakan UI Apigee.

Catatan: Untuk portal terintegrasi, akun pengguna dikelola seperti yang dijelaskan dalam Mengelola pengguna. Setelah developer membuat aplikasi di portal terintegrasi, seperti yang dijelaskan dalam Mendaftarkan aplikasi, data developer terpisah akan dibuat untuk melacak aplikasi yang terkait dengan akun pengguna dan dapat diakses di halaman Developer. Data developer dikaitkan menggunakan alamat email pengguna.

Untuk mengakses halaman Developer:

• Jika Anda menggunakan UI Apigee di Cloud Console: Pilih Distribution > Developers.
• Jika Anda menggunakan UI Apigee klasik: Pilih Publikasikan > Developer.

Halaman Developer memungkinkan Anda untuk:

• Menambahkan developer
• Melihat dan mengedit detail developer, termasuk hal berikut:
• Mengelola atribut khusus
• Mengaktifkan atau menonaktifkan developer
• Mengekspor data publikasi
• Menghapus developer
• Menelusuri daftar developer

Menambahkan developer

Untuk menambahkan developer:

1. Akses halaman Developer.
2. Klik + Developer.
3. Masukkan detail developer, termasuk nama depan, nama belakang, email, dan nama pengguna.
4. Klik Create.

Lihat juga Mengelola pengguna.

Melihat dan mengedit detail developer

Melihat dan mengedit detail developer.

Untuk melihat dan mengedit detail developer:

1. Akses halaman Developer.
2. Klik baris developer yang ingin Anda lihat dan edit untuk membuka detail developer.
3. Di bagian Details, informasi berikut akan ditampilkan. Edit detail developer, sesuai kebutuhan.

   Detail	Deskripsi
   Detail	Nama depan dan belakang, nama pengguna, dan email developer; status dan durasi pendaftaran; serta ID developer. Untuk mengedit detail developer, klik di dalam salah satu kolom berikut: Nama Depan Nama Belakang Email Nama pengguna Ubah konten dan tekan Enter untuk mengonfirmasi perubahan.
   Atribut khusus	Atribut kustom yang ditentukan untuk developer. Konfigurasikan atribut kustom, sesuai kebutuhan. Untuk mengetahui informasi selengkapnya, lihat: Mengelola atribut khusus untuk developer
   Aplikasi	Aplikasi yang telah didaftarkan oleh developer. Lihat Mengontrol akses ke API Anda dengan mendaftarkan aplikasi.

4. Aktifkan atau nonaktifkan developer di kolom Status.
   Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan dan menonaktifkan developer.

Apigee menyimpan entitas berikut dalam cache selama minimal 180 detik setelah entitas diakses.

• Token akses OAuth. Artinya, elemen ExpiresIn pada kebijakan OAuth v2 tidak akan dapat berakhir masa berlakunya token akses dalam waktu kurang dari 180 detik.
• Entitas Key Management Service (KMS) (Aplikasi, Developer, Produk API).
• Atribut kustom pada token OAuth dan entitas KMS.

Mengelola atribut khusus untuk developer

Tambahkan hingga 18 atribut kustom untuk setiap developer.

Untuk mengelola atribut khusus:

1. Akses halaman Developer.
2. Klik baris developer yang atribut kustomnya ingin Anda kelola untuk membuka detail developer.
3. Klik + di bagian Custom Attributes.
4. Masukkan nama dan nilai atribut.
5. Klik .
6. Untuk menghapus atribut kustom, posisikan kursor ke atribut tersebut, lalu klik di menu tindakan.

Mengaktifkan dan menonaktifkan developer

Saat developer aplikasi mendaftar sendiri di portal Anda, Anda dapat mengonfigurasi apakah mereka aktif secara default atau tidak.

Jika tidak aktif, developer masih dapat login ke portal developer dan membuat aplikasi, tetapi tidak ada kunci API yang sesuai yang akan berfungsi. Aplikasi developer masih mempertahankan statusnya yang disetujui (atau lainnya), begitu juga dengan kunci API, meskipun tidak valid saat developer tidak aktif.

Catatan: Saat Anda menonaktifkan developer, mungkin perlu waktu beberapa menit agar perubahan tersebut diperbarui di semua pemroses pesan. Hingga saat itu, beberapa panggilan oleh aplikasi developer mungkin berhasil.

Untuk mengaktifkan atau menonaktifkan developer:

1. Akses halaman Developer.
2. Klik baris developer yang ingin Anda aktifkan atau nonaktifkan untuk membuka detail developer.
3. Di bagian Detail, tetapkan kolom Status ke Aktif atau Tidak aktif, sesuai kebutuhan.
4. Ulangi langkah-langkah tersebut jika developer berada di beberapa organisasi.

Mengekspor data publikasi

Mengekspor data publikasi berikut sebagai file nilai yang dipisahkan koma (CSV):

• Detail developer
• Detail produk developer, aplikasi, dan API

Untuk mengekspor data publikasi:

1. Akses halaman Developer.
2. Klik Ekspor CSV...
3. Pilih Developer atau Developer, Aplikasi, dan Produk dari menu drop-down.

Data publikasi yang dipilih akan didownload sebagai file CSV.

Menghapus developer

Peringatan: Menghapus developer akan menghapusnya sepenuhnya beserta artefak terkait (seperti aplikasi dan kunci API) dari organisasi Anda. Untuk menghindari penghapusan developer dan artefaknya secara permanen, sebaiknya nonaktifkan developer.

Untuk menghapus developer:

1. Akses halaman Developer.
2. Posisikan kursor di atas baris developer yang ingin dihapus untuk menampilkan menu tindakan.
3. Klik .
4. Klik Delete untuk mengonfirmasi penghapusan.

Menyinkronkan developer aplikasi antara portal dan Apigee

Jika Anda menggunakan portal developer berbasis Drupal untuk memublikasikan API, perubahan yang dilakukan pada developer aplikasi yang menggunakan Apigee tidak akan diterapkan ke portal. Anda harus login ke portal sebagai administrator portal dan menyinkronkan portal dengan Apigee agar perubahan tersebut muncul di portal.

Catatan: Jika Anda menggunakan portal developer berbasis Drupal, Apigee merekomendasikan agar Anda mengelola developer aplikasi langsung di portal, bukan menggunakan Apigee. Lihat Rekomendasi untuk mengelola akun pengguna di portal developer.

Untuk menyinkronkan portal developer dengan developer aplikasi yang ditentukan di Apigee, lihat bagian berikut:

Drupal 10: Menyinkronkan developer dengan Apigee

Mengelola developer menggunakan API

Mengelola developer menggunakan Developer API.