Referensi CLI untuk Edge Microgateway

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

Edge Microgateway v. 3.3.x

Ringkasan

Edge Microgateway CLI memungkinkan Anda mengontrol dan mengelola semua aspek instance Edge Microgateway.

Mengelola sertifikat

Perintah cert memungkinkan Anda menginstal dan mengelola pasangan kunci publik/pribadi yang digunakan untuk menandatangani token pemilik yang digunakan oleh klien untuk melakukan panggilan aman melalui Edge Microgateway. Kunci disimpan di Apigee Edge dalam Peta Nilai Kunci (KVM) terenkripsi. Edge Microgateway menggunakan kunci publik untuk memvalidasi token pemilik bertanda tangan. Kunci ini dibuat saat Anda menjalankan perintah konfigurasi edgemicro, seperti yang dijelaskan dalam Menyiapkan dan mengonfigurasi Edge Microgateway. Anda dapat menggunakan perintah cert yang dijelaskan di sini untuk membuat ulang dan mengelola kunci ini jika diperlukan.

Instal sertifikat

Menginstal kunci di Peta Nilai Kunci (KVM) terenkripsi dan menampilkan kunci publik sebagai output. Pasangan kunci tercakup dalam organisasi yang ditentukan.

Penggunaan

edgemicro cert install -o [organization] -e [environment] -u [username] -p [password] --force

Parameter

Parameter Deskripsi
-o, --org Organisasi Apigee tempat Anda mengonfigurasi Edge Microgateway.
-e, --env Lingkungan tempat Anda mengonfigurasi Edge Microgateway.
-u, --username Nama pengguna Apigee Anda. Anda harus menjadi administrator org untuk organisasi yang ditentukan.
-p, --password (Opsional) Sandi Anda. Anda akan dikonfirmasi jika tidak memberikan parameter ini di command line.
-f, --force (Opsional) Jika kunci sudah disimpan di KVM terenkripsi, paksa penggantiannya.
-h, --help Menampilkan informasi penggunaan.

Contoh

edgemicro cert install -o docs -e test -u jdoe@example.com -f

Output

current nodejs version is v12.5.0
current edgemicro version is 3.0.2
password:
deleting vault
creating vault
adding private_key
adding public_key
installed cert

Menghapus sertifikat

Menghapus pasangan kunci untuk organisasi.

Penggunaan

edgemicro cert delete -o [organization] -e [environment] -u [username] -p [password]

Parameter

Parameter Deskripsi
-o, --org Organisasi Apigee tempat Anda mengonfigurasi Edge Microgateway.
-e, --env Lingkungan tempat Anda mengonfigurasi Edge Microgateway.
-u, --username Nama pengguna Apigee Anda. Anda harus menjadi administrator org untuk organisasi yang ditentukan.
-p, --password (Opsional) Sandi Anda. Anda akan dikonfirmasi jika tidak memberikan parameter ini di command line.
-h, --help Menampilkan informasi penggunaan.

Contoh

edgemicro cert delete -o docs -e test -u jdoe@example.com

Output

deleting vault
Vault deleted!

Memeriksa sertifikat

Memeriksa apakah organisasi Anda telah menginstal sertifikat.

Penggunaan

edgemicro cert check -o [organization] -e [environment] -u [username] -p [password]

Parameter

Parameter Deskripsi
-o, --org Organisasi Apigee tempat Anda mengonfigurasi Edge Microgateway.
-e, --env Lingkungan tempat Anda mengonfigurasi Edge Microgateway.
-u, --username Nama pengguna Apigee Anda. Anda harus menjadi administrator org untuk organisasi yang ditentukan.
-p, --password (Opsional) Sandi Anda. Anda akan dikonfirmasi jika tidak memberikan parameter ini di command line.
-h, --help Menampilkan informasi penggunaan.

Contoh

edgemicro cert check -o docs -e test -u jdoe@example.com

Output (Berhasil)

checked cert successfully

Output (Kegagalan)

Jika sertifikat tidak ada, pesan error akan ditampilkan.

Mendapatkan kunci publik

Menampilkan kunci publik untuk organisasi yang ditentukan. Tidak memerlukan autentikasi.

Penggunaan

edgemicro cert public-key -o [organization] -e [environment]

Parameter

Parameter Deskripsi
-o, --org Organisasi Apigee tempat Anda mengonfigurasi Edge Microgateway.
-e, --env Lingkungan tempat Anda mengonfigurasi Edge Microgateway.
-h, --help Menampilkan informasi penggunaan.

Contoh

edgemicro cert public-key -o docs -e test

Output (Sampel)

-----BEGIN CERTIFICATE-----

MIICpDCCAYwCCQCKpXWGum9uTjANBgkq9w0BAQsFADAUMRIwEAYDVQQDEwls
b2NhbGhvc3cNMTYxMTAyMjAxNTA2WhcNMTYxMTAzMjAxNTA2WjAUMRIwEAYD
VQQDEwlsb2Nvc3QwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDD
ETr/ne/gP47+9LgjLvBJjpbFVdaeUabZZ3wbA7sSIVnnNXWt3yPklrWSfIh+
L2+dq4k+YunsQE2+dwPdXA2x8DPGvqGcCdWPxnpZ7ix5Akbs8i/J+Ue0pXT4
jkpWbaDDftGL2tcxwP45yI+slpDYvmWRps07TFXkAPjGEHYPvCT9/v/35GkL
0h4v0S+XfpcjS5c47o7CIWlkgEM5GBosQUb17kuVR48392vGFPsnCP34iNe7
zguhiCXYg2zkOcj/N3AE4xKIhCz0QcewULy08GltWMmyjJ/30zs8P41JqoA4
RwfeEZ8RenN3rJQim1ppAAEwDQYJKoZIhvcNAQELBQADggEBAHcORIfc+ySe
2FMmqicNe6Wt5V/5zOaBMLsGQdqGOHB5cQc79sMBrk680KVhrwHXZ2nBIkVe
UEL+2qLY1VLfswBNAvcNwV9U4TwHq4eIANiD751oJK1tHmM/ujThQkwNf96o
6I7Ws+wfpGO3ppJCttRbtnATIxrwsCHN4i5lbW/tJSL7t/Zf6T1B+YSJU9AF
xuvLq22cCqyYJQdmKq2vVS55WRZdllm+mRtJrv7MLM9gfDPRxVlwrBz/eQHy
Fv+dwzxcvQjkz03RNhZUodzuD34DPJoYeK++rItsddwQ26KTahH80yYTAFzY
x9gfPf1/+qo=?

-----END CERTIFICATE-----

Mengonfigurasi Edge Microgateway untuk Apigee Edge Cloud

Memungkinkan Edge Microgateway beroperasi dengan instance Apigee Edge Cloud. Layanan ini menggabungkan dan menjalankan urutan perintah untuk men-deploy proxy autentikasi yang diperlukan ke Edge, menghasilkan token autentikasi, dan mengupdate file konfigurasi. Untuk contoh kerja lengkap, lihat Menyiapkan dan mengonfigurasi Edge Microgateway.

Penggunaan

edgemicro configure -o [organization] -e [environment] -u [username] -p [password]

Parameter

Parameter Deskripsi
-o, --org Organisasi Apigee tempat Anda mengonfigurasi Edge Microgateway.
-e, --env Lingkungan tempat Anda mengonfigurasi Edge Microgateway.
-u, --username Nama pengguna Apigee Anda. Anda harus menjadi administrator org untuk organisasi yang ditentukan.
-p, --password (Opsional) Sandi Anda. Anda akan dikonfirmasi jika tidak memberikan parameter ini di command line.
-r, --url (Opsional) Menentukan alias host virtual untuk organisasi:lingkungan Anda. Lihat dokumentasi Edge untuk mempelajari host virtual. Default: org-env.apigee.net
-c, --configDir (Opsional) Menentukan jalur ke file konfigurasi Edge Microgateway. Secara default, file konfigurasi ada di ./config/config.yaml. (Ditambahkan v2.4.x)
-x, --proxyName (Opsional) Menetapkan basepath untuk proxy edgemicro-auth. Jika proxy edgemicro-auth diterapkan dengan jalur yang berbeda dari default, /edgemicro-auth, fitur ini memungkinkan Anda untuk menetapkan jalur baru di Edge Microgateway. Secara default, basepath-nya adalah /edgemicro-auth. (Ditambahkan v2.4.x)
-t, --token (Opsional) Memungkinkan Anda menggunakan token OAuth untuk autentikasi, bukan nama pengguna/sandi. Lihat juga Mengamankan panggilan API dengan token akses OAuth2. Contoh:

edgemicro configure -o docs -e test -t <your token>
-v, --virtualHosts (Opsional) Mengganti host virtual default, yaitu "default,secure". Gunakan opsi ini jika Anda memiliki host virtual yang ditentukan untuk organisasi Edge:environment selain default ini. Lihat dokumentasi Edge untuk mempelajari host virtual.
-d, --debug (Opsional) Memberikan informasi debug.
-h, --help Menampilkan informasi penggunaan.

Catatan penggunaan

Perintah ini menyimpan informasi konfigurasi di ~/.edgemicro/org-env-config.yaml.

Contoh

edgemicro configure -o docs -e test -u jdoe@example.com

Output

Jika berhasil, perintah akan menampilkan serangkaian kunci yang perlu Anda gunakan saat memulai Edge Microgateway.

...

The following credentials are required to start edge micro
  key: d2f0a246ad52b5d2a8b04ba65b43c76348aba586691cf6185cd7bb9fb78fe9f
  secret: 59813bc1db4a7ada182705ae40893c28a6fae680c3deb42aefbf1a4db42e372

edgemicro configuration complete!

Membuat kunci

Perintah genkeys menghasilkan pasangan kunci dan rahasia yang digunakan oleh Edge Microgateway untuk mengautentikasi dirinya sendiri saat memposting data analisis secara asinkron ke Apigee Edge.

Penggunaan

edgemicro genkeys -o [organization] -e [environment] -u [username] -p [password]

Parameter

Parameter Deskripsi
-o, --org Organisasi Apigee tempat Anda mengonfigurasi Edge Microgateway.
-e, --env Lingkungan tempat Anda mengonfigurasi Edge Microgateway.
-u, --username Nama pengguna Apigee Anda. Anda harus menjadi administrator org untuk organisasi yang ditentukan.
-p, --password (Opsional) Sandi Anda. Anda akan dikonfirmasi jika tidak memberikan parameter ini di command line.
-t, --token (Opsional) Memungkinkan Anda menggunakan token OAuth untuk autentikasi, bukan nama pengguna/sandi. Lihat juga Mengamankan panggilan API dengan token akses OAuth2. Contoh:

edgemicro genkeys -o docs -e test -t <your token>
-h, --help Menampilkan informasi penggunaan.

Catatan penggunaan

Setelah berhasil, perintah mengembalikan tiga item. Yang pertama adalah URL yang perlu Anda tempatkan di file konfigurasi. Dua lainnya adalah pasangan kunci yang diperlukan saat Anda memulai instance Edge Microgateway.

  • URL bootstrap: URL ini mengarah ke layanan Apigee Edge yang memungkinkan instance Edge Microgateway mengirim data analisis ke Apigee Edge. Anda perlu menyalin URL tersebut ke file konfigurasi Edge Microgateway: ~/.edgemicro/org-env-config.yaml.
  • key: Kunci. Kunci ini, dan rahasianya, diperlukan sebagai input ke perintah CLI yang digunakan untuk memulai instance Edge Microgateway.
  • secret: Rahasia.

Contoh

edgemicro genkeys -o docs -e test -u jdoe@example.com

Output (Sampel)

Jika berhasil, perintah akan menampilkan serangkaian kunci yang perlu Anda gunakan saat memulai Edge Microgateway.

configuring host edgemicroservices-us-east-1.apigee.net for region us-east-1
Please copy the following property to the edge micro agent config
  bootstrap: https://edgemicroservices-us-east-1.apigee.net/edgemicro/bootstrap/organization/jdoe/environment/test

The following credentials are required to start edge micro
  key: db39324077989c75eac34c13d285772ea8e3b982b957b3f52916f3048511443f
  secret: 5bf8da39de0056f88fdd5f25a8602d22f312c1c8c870580a5fef55ac6637b7ae

finished

Mengonfigurasi Edge Microgateway untuk Apigee Edge Private Cloud

Mengonfigurasi Edge Microgateway agar berfungsi dengan penginstalan Apigee Edge Private Cloud.

Penggunaan

edgemicro private configure -o [organization] -e [environment] -u [username] -p [password]

Parameter

Parameter Deskripsi
-o, --org Organisasi Apigee tempat Anda mengonfigurasi Edge Microgateway.
-e, --env Lingkungan tempat Anda mengonfigurasi Edge Microgateway.
-u, --username Nama pengguna Apigee Anda. Anda harus menjadi administrator org untuk organisasi yang ditentukan.
-p, --password (Opsional) Sandi Anda. Anda akan dikonfirmasi jika tidak memberikan parameter ini di command line.
-r, --runtime-url Menentukan URL runtime untuk instance cloud pribadi Anda.
-m, --mgmt-url URL server pengelolaan untuk instance cloud pribadi Anda.
-v, --virtualHosts Daftar host virtual yang dipisahkan koma untuk organisasi:lingkungan Anda. Default "default,secure".
-c, --configDir (Opsional) Menentukan jalur ke file konfigurasi Edge Microgateway. Secara default, file konfigurasi ada di ./config/config.yaml. (Ditambahkan v2.4.x)
-t, --token (Opsional) Memungkinkan Anda menggunakan token OAuth untuk autentikasi, bukan nama pengguna/sandi. Lihat juga Mengamankan panggilan API dengan token akses OAuth2. Contoh:

edgemicro configure -o docs -e test -t <your token>
-d, --debug (Opsional) Memberikan informasi debug.
-h, --help Menampilkan informasi penggunaan.

Catatan penggunaan

Perintah ini menyimpan informasi konfigurasi di ~/.edgemicro/org-env-config.yaml.

Contoh

edgemicro private configure -o docs -e test -u jdoe@example.com -r http://192.162.55.100:9002 -m http://192.162.55.100:8080

Output

Jika berhasil, perintah akan menampilkan serangkaian kunci yang perlu Anda gunakan saat memulai Edge Microgateway.

...

The following credentials are required to start edge micro
  key: d2f0a246ad52b5d2a8b04ba65b43c76348aba586691cf6185cd7bb9fb78fe9f
  secret: 59813bc1db4a7ada182705ae40893c28a6fae680c3deb42aefbf1a4db42e372

edgemicro configuration complete!

Memulai Edge Microgateway

Sebelum memulai Edge Microgateway, Anda harus menjalankan konfigurasi edgemicro (Cloud Publik) atau konfigurasi pribadi edgemicro (Private Cloud) terlebih dahulu. Perintah konfigurasi menampilkan nilai kunci dan rahasia yang diperlukan untuk memulai Edge Microgateway.

Penggunaan

edgemicro start -o [organization] -e [environment] -k [public-key] -s [secret-key]

Parameter

Parameter Deskripsi
-o, --org Organisasi Apigee tempat Anda mengonfigurasi Edge Microgateway.
-e, --env Lingkungan tempat Anda mengonfigurasi Edge Microgateway.
-k, --key Nilai kunci yang ditampilkan saat Anda menjalankan perintah "edgemicro configure".
-s, --secret Nilai secret yang ditampilkan saat Anda menjalankan perintah "edgemicro configure".
-p, --processes (Opsional) Jumlah proses yang akan dimulai. Default: Jumlah inti pada sistem Anda.
-d, --pluginDir (Opsional) Jalur absolut ke direktori plugin.
-r, --port (Opsional) Mengganti nomor port yang ditentukan dalam file ~/.edgemicro/org-env-config.yaml. Default: 8000
-c, --cluster

(Opsional) Memulai Edge Microgateway dalam mode cluster.

Catatan: Mulai v2.3.1, opsi ini telah dihapus. Di v2.3.1 dan versi yang lebih baru, Edge Micro selalu dimulai dalam mode cluster.

-c, --configDir (Opsional) Menentukan jalur ke file konfigurasi Edge Microgateway. Secara default, file konfigurasi ada di ./config/config.yaml. (Ditambahkan v2.4.x)
-u, --configUrl (Opsional) Menentukan endpoint tempat Edge Microgateway akan mendownload file konfigurasinya. (Ditambahkan v2.5.x)
-d, --debug (Opsional) Memberikan informasi debug.
-h, --help Menampilkan informasi penggunaan.

Menyetel port

Perintah start memungkinkan Anda menentukan nomor port untuk mengganti port yang ditentukan dalam file konfigurasi. Anda juga dapat menentukan nomor port menggunakan variabel lingkungan PORT. Contoh:

edgemicro start -o docs -e test -k abc123 -s xyz456 -p 2 --port 8002

atau

export PORT=8002
edgemicro start -o org -e test -k key -s secret -p 2

Jika port sedang digunakan, Edge Microgateway akan menampilkan error.

Tentang pengelompokan

Edge Microgateway menggunakan modul cluster Node.js untuk mengaktifkan pengelompokan. Dengan clustering, Edge Microgateway dapat memanfaatkan sistem multi-core. Untuk mengetahui detailnya, lihat dokumentasi Node.js ini.

Contoh

edgemicro start -o docs -e test -k abc123 -s xyz456

Contoh output:

...

current nodejs version is v12.5.0
current edgemicro version is 3.0.2
info: jwk_public_keys download from null returned 200 undefined
info: jwt_public_key download from https://docs-test.apigee.net/edgemicro-auth/publicKey returned 200 OK
info: products download from https://docs-test.apigee.net/edgemicro-auth/products returned 200 OK
info: config download from https://edgemicroservices-us-east-1.apigee.net/edgemicro/bootstrap/organization/docs/environment/test returned 200 OK
PROCESS PID : 17991

Mengelola token

Perintah token memungkinkan Anda mendapatkan, mendekode, dan memverifikasi token akses OAuth2 yang ditandatangani. Lihat juga Mengamankan panggilan API dengan token akses OAuth2.

Mendekode token

Mendekode token pemilik yang ditandatangani dan dienkode ke representasi JSON JWT (Java Web Token) teks biasa. Token menyampaikan informasi tentang aplikasi developer Apigee Edge yang menyediakan kunci yang digunakan untuk membuat token, termasuk nama aplikasi, client_id, daftar produk, dan banyak lagi.

Penggunaan

edgemicro token decode -f [filename]

Parameter

Parameter Deskripsi
-f, --file Nama file yang berisi token JWT yang akan didekode.
-h, --help Menampilkan informasi penggunaan.

Contoh

edgemicro token decode -f token.jwt

Output (Contoh)

{ header: { typ: 'JWT', alg: 'RS256' },

  payload:
   { application_name: 'b43342ef-86f6-4666-a121-b9ac2025d217',
     client_id: 'O9ZQRZKnn1rdgcKQgsABSMdOsKS',
     scopes: [],
     api_product_list: [ 'MicroTest' ],
     iat: 1436280566,
     exp: 1436282365 },
  signature: '' }

Membuat token

Membuat token pemilik yang ditandatangani. Token tersebut memungkinkan aplikasi klien melakukan panggilan API yang diautentikasi ke Edge Microgateway. Token tersebut adalah Token Web JSON (JWT) yang mematuhi OAuth 2.0. Diperlukan sebagai memasukkan nilai Kunci Konsumen (ID klien) dan Rahasia Konsumen (rahasia klien) dari aplikasi developer yang terdaftar di Apigee Edge. Lihat juga Mengamankan panggilan API dengan token akses OAuth2.

Penggunaan

edgemicro token get -o [org] -e [env] -i [client_id] -s [client_secret]

Parameter

Parameter Deskripsi
-o, --org Organisasi Apigee tempat Anda mengonfigurasi Edge Microgateway.
-e, --env Lingkungan tempat Anda mengonfigurasi Edge Microgateway.
-1, --key Client ID dari Aplikasi Developer yang terkait dengan proxy berbasis Microgateway Anda.
-s, --secret Rahasia Klien dari aplikasi Developer yang terkait dengan proxy berbasis Microgateway Anda.
-h, --help Menampilkan informasi penggunaan.

Contoh

edgemicro token get -o docs -e test -i 5UzOwAXGoOeo60aew94PPG5MAZE3aJp -s 6vahKFGS9a3qMLwz

Output (Contoh)

{ token: 'eyJ0eXAiOiJKV1JhbGciOiJSUzI1NiJ9Glvbl9uYW1lIjoiNWNiMGY0NTV6TV3
EtOWMzOC00YmJjLWIzNzEtZGMxZTQzOGMxIiwiY2xpZW50X2lkIjoiNVV6T3dBWEdvSU9lbz
YwYWV3OTRQN0c1TUFaRTNhSnAiLCJzY2MiOltdLCJhcGlfcHJvZHVjdF9saXN0IjpbIkVkZ2
VNaWNyb1Rlc3RQcm9kdWN0Il0sImlhdCI3ODEyMzQ2MSwiZXhwIjoxNDc4MTI1MjYwfQ.Dx5
f5U7PXm8koNGmFX4N6VrxKMJnpndKgoJ5zWSJvBZ6Ccvhlpd85ipIIA5S2A5nx4obYWp_rpY
RJpIGYwyxP6Oq2j0rxnVjdCC4qyYMgthZjhKgEBVBe3s1ndP72GP2vV6PsSA9RQ2-yzsy9r0
TzhAZ3NJTxT1tS0XKqKngE-OhR3fJHVLAzdMDT0AmS9H0Z2NAJtQOuK6RTpCjG9B6Bc48AEM
sj7QSM-1LWiQ8LdY8k_BoC06qsTI7bCQGWwTuqL-ismbcx2bxovUxSemZIaoROfuF-dCZHG3
2aTP75WxBvvNgBBvPvQtPzbeSOtEaww' }

Anda juga dapat membuat JWT menggunakan API pengelolaan:

curl -i -X POST "http://$ORG-$ENV.apigee.net/edgemicro-auth/token" \
  -H "Content-Type: application/json" \
  -d '{
    "$CLIENT_ID": "your consumer key",
    "$CLIENT_SECRET": "your consumer secret",
    "grant_type": "client_credentials"
  }'

Dengan keterangan:

  • $ORG adalah nama organisasi Edge Anda (Anda harus menjadi administrator org).
  • $ENV adalah lingkungan dalam organisasi Anda (seperti "test" atau "prod").
  • $CLIENT_ID adalah ID Konsumen di Aplikasi Developer yang Anda buat sebelumnya.
  • $CLIENT_SECRET adalah Rahasia Konsumen di Aplikasi Developer yang Anda buat sebelumnya.

Memverifikasi token

Memverifikasi token pemilik yang ditandatangani terhadap kunci publik yang disimpan di Apigee Edge untuk organisasi dan lingkungan yang ditentukan.

Penggunaan

edgemicro token verify -o [org] -e [env] -f [filename]

Parameter

Parameter Deskripsi
-o, --org Organisasi Apigee tempat Anda mengonfigurasi Edge Microgateway.
-e, --env Lingkungan tempat Anda mengonfigurasi Edge Microgateway.
-f, --file Nama file yang berisi JWT yang akan diverifikasi.
-h, --help Menampilkan informasi penggunaan.

Contoh

edgemicro token get -o docs -e test -f token.jwt

Contoh output untuk token yang valid

{ application_name: 'b43342ef-86f6-4666-a121-b9ac2025d217',

  client_id: 'O9ZQRZKnn1rdgcKQsAZUBkQSMdOsKS',

  scopes: [],

  api_product_list: [ 'MicroTest' ],

  iat: 1436396155,

  exp: 1436397954 }

Contoh output untuk token yang tidak valid

{ [JsonWebTokenError: invalid token] name: 'JsonWebTokenError', message: 'invalid token' }

Contoh output untuk token yang sudah tidak berlaku

{ [TokenExpiredError: jwt expired]

  name: 'TokenExpiredError',

  message: 'jwt expired',

  expiredAt: Tue Jul 07 2015 09:19:25 GMT-0600 (MDT) }

Menginisialisasi konfigurasi Edge Microgateway baru

Jalankan perintah ini satu kali setelah Anda pertama kali menginstal Edge Microgateway. Membuat file konfigurasi default baru: ~/.edgemicro/default.yaml.

Penggunaan

edgemicro init

Parameter

Parameter Deskripsi
-c, --configDir (Opsional) Menentukan jalur ke file konfigurasi Edge Microgateway. Secara default, file konfigurasi ada di ./config/config.yaml. (Ditambahkan v2.4.x)
-h, --help Menampilkan informasi penggunaan.

Contoh

edgemicro init

Output (Berhasil)

config initialized to /MyHome/.edgemicro/default.yaml

Memverifikasi konfigurasi Edge Microgateway

Memverifikasi bahwa Edge Microgateway dikonfigurasi dengan benar.

Penggunaan

edgemicro verify -o [organization] -e [environment] -k [public-key] -s [secret-key]

Parameter

Contoh

edgemicro verify -o docs -e test -k abc123 -s xyz456

Output (Berhasil)

logging to /var/tmp/edgemicro-My-Machine.local-a0c48610-a148-11e6-8466-93f081b05988
installed plugin from analytics
installed plugin from oauth
a0c48610-a148-11e6-8466-93f081b05988 edge micro listening on port 8000
verifying analytics negative case: OK
verifying bootstrap url availability:OK
verifying jwt_public_key availability: OK
verifying products availability: OK
verifying quota with configured products: OK
verifying analytics with payload: OK
verification complete

Memeriksa status cluster microgateway

Secara default, Edge Microgateway dimulai dalam mode cluster. Anda dapat menggunakan perintah ini untuk memeriksa status cluster.

Penggunaan

edgemicro status

Parameter

Parameter Deskripsi
-h, --help Menampilkan informasi penggunaan.

Contoh

edgemicro status

Output (Berhasil)

current nodejs version is v12.5.0
current edgemicro version is 3.0.2
edgemicro is running with 8 workers

Menghentikan cluster microgateway

Menghentikan cluster Edge Microgateway.

Penggunaan

edgemicro stop

Parameter

Parameter Deskripsi
-h, --help Menampilkan informasi penggunaan.

Contoh

edgemicro stop

Output (Berhasil)

current nodejs version is v12.5.0
current edgemicro version is 3.0.2
Stop Completed Successfully

Memuat ulang cluster microgateway

Menyediakan mulai ulang tanpa periode nonaktif setelah perubahan konfigurasi. Memuat ulang Edge Microgateway dengan menarik konfigurasi baru.

Penggunaan

edgemicro reload -o [organization] -e [environment] -k [public-key] -s [secret-key]

Parameter

Parameter Deskripsi
-o, --org Organisasi Apigee tempat Anda mengonfigurasi Edge Microgateway.
-e, --env Lingkungan tempat Anda mengonfigurasi Edge Microgateway.
-k, --key Nilai kunci yang ditampilkan saat Anda menjalankan perintah "edgemicro configure".
-s, --secret Nilai secret yang ditampilkan saat Anda menjalankan perintah "edgemicro configure".
-h, --help Menampilkan informasi penggunaan.

Contoh

edgemicro reload -o docs -e test -k abc123 -s xyz456

Output (Berhasil)

...

Reload Completed Successfully

Mengupgrade proxy edgemicro-auth

Untuk menggunakan rotasi kunci, Anda harus memiliki proxy edgemicro-auth yang telah diupgrade yang di-deploy di organisasi Apigee Edge Anda. (Ditambahkan v2.5.x)

Catatan: Jika Anda mengonfigurasi instance Edge Micro saat ini sebelum versi 2.5.2, Anda harus mengupgrade proxy ini jika ingin menggunakan rotasi kunci. Anda hanya perlu melakukan upgrade ini satu kali.

Penggunaan

edgemicro upgradeauth -o [organization] -e [environment] -u [username]

Parameter

Parameter Deskripsi
-o, --org Organisasi Apigee tempat Anda mengonfigurasi Edge Microgateway.
-e, --env Lingkungan tempat Anda mengonfigurasi Edge Microgateway.
-u, --username Nama pengguna Apigee Anda. Anda harus menjadi administrator org untuk organisasi yang ditentukan.
-p, --password (Opsional) Sandi Anda. Anda akan dikonfirmasi jika tidak memberikan parameter ini di command line.
-v, --virtualhost (Opsional) Host virtual proxy.
-b, --baseuri (Opsional) URI dasar untuk organisasi Anda di Apigee Edge. Defaultnya adalah URI dasar untuk deployment cloud Apigee adalah api.enterprise.apigee.com. Untuk deployment lokal, URL dasarnya mungkin berbeda.

Contoh

edgemicro upgradeauth -o docs -e test -u jdoe@example.com

Output (Berhasil)

Setelah berhasil, perintah menampilkan output yang mirip dengan berikut ini:

Going to create revision 2 of API edgemicro-auth
Using /Users/jdoe/npm/lib/node_modules/edgemicro/node_modules/microgateway-edgeauth/apiproxy/edgemicro-auth.xml as the root file
Creating revision 2 of API edgemicro-auth
Uploading java resource micro-gateway-products-javacallout-2.0.0.jar
Uploading jsc resource generate-verify-jwt.js
Uploading jsc resource send-public-key.js
Uploading jsc resource set-jwt-variables.js
Uploading jsc resource set-response.js
Uploading node resource index.js
Uploading node resource node_modules_apigee-access.zip
Uploading node resource node_modules_base64url.zip
Uploading node resource node_modules_buffer-equal-constant-time.zip
Uploading node resource node_modules_ecdsa-sig-formatter.zip
Uploading node resource node_modules_jsrsasign.zip
Uploading node resource node_modules_jwa.zip
Uploading node resource node_modules_jws.zip
Uploading node resource node_modules_safe-buffer.zip
Uploading node resource package.json
Uploading policy Access-App-Info-2.xml
Uploading policy Access-App-Info.xml
Uploading policy AccessTokenRequest.xml
Uploading policy Add-Custom-Claims.xml
Uploading policy Create-OAuth-Request.xml
Uploading policy Create-Refresh-Request.xml
Uploading policy Extract-API-Key.xml
Uploading policy Extract-OAuth-Params.xml
Uploading policy Extract-Refresh-Params.xml
Uploading policy Get-Private-Key.xml
Uploading policy Get-Public-Key.xml
Uploading policy Get-Public-Keys.xml
Uploading policy JavaCallout.xml
Uploading policy Products-to-JSON-2.xml
Uploading policy Products-to-JSON.xml
Uploading policy Raise-Fault-Unknown-Request.xml
Uploading policy RefreshAccessToken.xml
Uploading policy Send-Public-Key.xml
Uploading policy Set-JWT-Variables.xml
Uploading policy Set-Response.xml
Uploading policy Verify-API-Key.xml
Uploading target TargetEndpoint-1
Uploading proxy default
Deploying revision 2 of edgemicro-auth to test
Deployment on test successful
edgemicro-auth proxy upgraded

Upgrade Peta Nilai Kunci (KVM)

Gunakan perintah edgemicro upgradekvm untuk mengupgrade KVM di organisasi Apigee Anda. Upgrade KVM diperlukan jika ingin menggunakan rotasi kunci.

Penggunaan

Edge untuk Cloud Publik:

edgemicro upgradekvm -o [organization] -e [environment] -k [key] -s [secret]

Edge untuk Private Cloud:

edgemicro private upgradekvm -o [organization] -e [environment] -k [key] -s [secret] -p 'https://[hostname]/edgemicro-auth'

Parameter

Parameter Deskripsi
-o, --org Organisasi Apigee tempat Anda mengonfigurasi Edge Microgateway.
-e, --env Lingkungan tempat Anda mengonfigurasi Edge Microgateway.
-k, --key Nilai kunci yang ditampilkan saat Anda menjalankan perintah "edgemicro configure".
-s, --secret Nilai secret yang ditampilkan saat Anda menjalankan perintah "edgemicro configure".
-p, --proxyuri URI untuk proxy edgemicro_auth

Edge Public Cloud: Opsional.
Edge Private Cloud: Wajib.

Contoh Cloud Public Edge:

 -p 'https://[org]-[env].apigee.net/edgemicro-auth'

Contoh Edge Private Cloud:

-p 'https://[hostname]/edgemicro-auth'

Contoh

edgemicro upgradekvm -o docs -e test \
-k 27ee39567c75e4567a66236cbd4e86d1cc93df6481454301bd5fac4d3497fcbb \
-s 4618b0008a6185d7327ebf53bee3c50282ccf45a3cceb1ed9828bfbcf1148b47

Output (Berhasil)

Setelah berhasil, perintah menampilkan output yang mirip dengan berikut ini:

current nodejs version is v12.5.0
current edgemicro version is 3.1.5
password:
Checking for certificate...
Certificate found!
-----BEGIN PUBLIC KEY-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAsT6yVoT/h6pvkPlkUUtv
Hgs7MbDPcWxto7dZqJBwQ4oOQ0IJ2P4XGigc3kYUyPp5lFHg1ssP9+0onRpqn6Lq
z7N5iaTSv5YXb26bU2kSOl4hbwcljIzauAnBzQ13VaQ5SoflRxMGSZmTqZeu5jkQ
3JZ7F6k2bCar5sk1k84vd4WXcCVyngFlrMtlux5z0vOU56QYZFvvKYl/wOHNPLLB
Js54531CV1ZfhV3nDDq9Lh5D1C/oQVlm1Lc7BJoEUmKeFATmSsi50c14ScsmdtJ1
HqC/brSXCd185P6ifu2RH7IHKzNfcD4NlfAVmDScng4w5RxBan2avbmAJrokQ4b5
WQIDAQAB
-----END PUBLIC KEY-----
KVM update complete

Rotasi kunci

Gunakan perintah edgemicro rotatekey untuk merotasi pasangan kunci publik/pribadi yang digunakan untuk membuat token JWT yang digunakan untuk keamanan OAuth di Edge Microgateway.

Untuk mempelajari lebih lanjut, lihat Merotasi kunci JWT.

Penggunaan

Edge untuk Cloud Publik:

edgemicro rotatekey -o [organization] -e [environment] -k [key] -s [secret]

Edge untuk Private Cloud:

edgemicro private rotatekey -o [organization] -e [environment] -k [key] -s [secret] -r '[hostname]/edgemicro-auth/rotateKey'

Parameter

Parameter Deskripsi
-o, --org (Wajib) Organisasi Apigee tempat Anda mengonfigurasi Edge Microgateway.
-e, --env (Wajib) Lingkungan yang Anda gunakan untuk mengonfigurasi Edge Microgateway.
-k, --key Nilai kunci yang ditampilkan saat Anda menjalankan perintah "edgemicro configure".
-s, --secret Nilai secret yang ditampilkan saat Anda menjalankan perintah "edgemicro configure".
-p Jalur ke kunci pribadi kustom yang akan digunakan oleh Apigee Edge. (Ditambahkan 3.1.6)
-c Jalur ke sertifikat kustom yang akan digunakan oleh Apigee Edge. (Ditambahkan 3.1.6)
-n, --nbf

Konfigurasi penundaan dalam menit agar kunci pribadi baru menjadi efektif. Penundaan ini memberikan waktu bagi instance microgateway untuk diperbarui dengan kunci publik baru. Praktik yang baik adalah menetapkan penundaan menjadi lebih dari setelan konfigurasi config_change_poll_internal, yaitu 10 menit secara default. Untuk informasi selengkapnya, lihat Mengonfigurasi penundaan "not before". (Ditambahkan 3.1.6)

Catatan: Jika Anda menggunakan opsi ini dengan versi edgemicro-auth yang lebih lama dari versi yang didistribusikan dengan Edge Microgateway 3.1.6, tanda akan diabaikan.

-i, --kid (Opsional) ID yang digunakan untuk mencocokkan kunci tertentu. Edge Microgateway menggunakan nilai ini untuk memilih di antara serangkaian kunci selama rotasi kunci. Jika parameter ini dihilangkan (direkomendasikan), Edge Microgateway akan membuat kunci berbasis stempel waktu. Untuk mengetahui informasi selengkapnya, lihat Bagian 4.5 spesifikasi Kunci Web JSON.
-r, --rotatekeyuri Rotasi URI kunci.

Edge Public Cloud: Opsional.
Edge Private Cloud: Wajib.

Contoh Cloud Publik:

-r 'https://[org]-[env].apigee.net/edgemicro-auth/rotateKey'

Contoh Edge Private Cloud:

-r '[hostname]/edgemicro-auth/rotateKey'

Contoh

edgemicro rotatekey -o docs -e test \
-k 27ee39567c75e4567a66236cbd4e86d1cc93df6481454301bd5fac4d3497fcbb \
-s 4618b0008a6185d7327ebf53bee3c50282ccf45a3cceb1ed9828bfbcf1148b47

Output (Berhasil)

Setelah berhasil, perintah menampilkan output yang mirip dengan berikut ini:

current nodejs version is v12.5.0
current edgemicro version is 3.0.2
password:
Checking if private key exists in the KVM...
Checking for certificate...
Found Certificate
Generating New key/cert pair...
Extract new public key
Key Rotation successfully completed!

Setelah rotasi, Anda dapat melihat di UI Edge bahwa kunci baru telah ditambahkan ke KVM microgateway.

Contoh

Contoh ini menggunakan tanda -p dan -c untuk menentukan jalur ke pasangan kunci/sertifikat pribadi. Opsi ini memungkinkan Anda meneruskan pasangan sertifikat dan kunci pribadi kustom.

edgemicro rotatekey -o docs -e test \
-k 27ee39567c75e4567a66236cbd4e86d1cc93df6481454301bd5fac4d3497fcbb \
-s 4618b0008a6185d7327ebf53bee3c50282ccf45a3cceb1ed9828bfbcf1148b47 \
-p /users/home/keys.pem -c /users/home/cert.cert

Pemantauan selamanya

Gunakan perintah edgemicro forever untuk mengelola proses Forever, sebuah alat Node.js yang otomatis memulai ulang aplikasi Node.js jika aplikasi tidak berfungsi atau mengalami error. Lihat juga Pemantauan selamanya.

Penggunaan

Anda harus menetapkan variabel lingkungan berikut sebelum menjalankan perintah edgemicro forever:

  • EDGEMICRO_ORG - Organisasi Apigee tempat Anda mengonfigurasi Edge Microgateway.
  • EDGEMICRO_ENV - Lingkungan tempat Anda mengonfigurasi Edge Microgateway.
  • EDGEMICRO_KEY - Nilai kunci yang ditampilkan saat Anda menjalankan perintah "edgemicro Configure".
  • EDGEMICRO_SECRET - Nilai secret yang ditampilkan, yang ditampilkan saat Anda menjalankan perintah "edgemicro Configure".
edgemicro forever -f [forever_file] -a [start|stop]

Parameter

ParameterDeskripsi
-f, --fileMenentukan lokasi file forever.json.
-a, --actionBerupa start atau stop. Default-nya adalah mulai.

Contoh:

Untuk memulai Selamanya:

edgemicro forever -f ~/mydir/forever.json -a start

Untuk menghentikan Selamanya:

edgemicro forever -a stop

Cabut kunci

Gunakan perintah edgemicro revokekeys untuk mencabut kredensial kunci dan rahasia untuk konfigurasi Edge Microgateway.

Penggunaan

edgemicro revokekeys -o [organization] -e [environment] -u [username]
-k [key] -s [secret]

Parameter

Parameter Deskripsi
-o, --org (Wajib) Organisasi Apigee tempat Anda mengonfigurasi Edge Microgateway.
-e, --env (Wajib) Lingkungan yang Anda gunakan untuk mengonfigurasi Edge Microgateway.
-u, --username (-u atau -t wajib diisi) Nama pengguna Apigee Anda. Anda harus menjadi administrator org untuk organisasi yang ditentukan. Parameter ini tidak diperlukan jika Anda justru menentukan parameter -t.
-p, --password (Opsional) Sandi Anda. Anda akan dikonfirmasi jika tidak memberikan parameter ini di command line.
-k, --key (Wajib) Kunci yang akan dicabut.
-s, --secret (Wajib) Rahasia yang akan dicabut.
-t, --token (-u atau -t wajib diisi) Memungkinkan Anda menggunakan token OAuth untuk autentikasi, bukan nama pengguna/sandi. Jika -t ditentukan, parameter -u tidak diperlukan. Lihat juga Mengamankan panggilan API dengan token akses OAuth2. Contoh:
edgemicro revokekeys -o ORG-NAME -e ENV-NAME -k KEY-TO-REVOKE \
    -s KEY-SECRET -t TOKEN

Contoh

edgemicro revokekeys -o myorg -e test -u jdoe@apigee.com
-k 2c0064f5bd85f5573dcaffe21566fa7a2d49885cdbf8899370c8a4479285f -s 4b5d6355b874f7c46838893823e8d929dcb2e42fb9aebcb535089c9b98513

Jika berhasil, Anda akan melihat pesan berikut:

key 2c0064f5bd85f5573dcaffe21566fa7a2d49885cdbf8899370c8a4479285f revoked successfully