Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi
Bu konuda, Edge Microgateway'in Docker container'ında nasıl çalıştırılacağı açıklanmaktadır. Bu konuda ele alınan adımlarda, Docker, Docker komutları ve Edge Microgateway kurulumu ve yapılandırması hakkında temel bilgilere sahip olduğunuz varsayılır. Daha fazla bilgi için Docker ve Edge Microgateway belgelerine bakın.
Ön koşullar
Edge Microgateway'i bir Docker container'da çalıştırmadan önce aşağıdaki görevleri yapmanız gerekir:
Apigee kuruluşunuz/ortamınız için Edge Microgateway'i yapılandırma:
edgemicro configure -o your_org -e your_env -u your_username
Yapılandırma hakkında daha fazla bilgi için 1. Bölüm: Edge Microgateway'i yapılandırma başlıklı makaleyi inceleyin.
Yapılandırma adımlarını uyguladıktan sonra yapılandırma dosyasını bulun. Varsayılan konum şöyledir:
$HOME/.edgemicro/your_org-your_env-config.yaml
Burada
your_orgveyour_env,edgemicro configkomutunu çalıştırırken kullandığınız kuruluş ve ortamdır. Edge Microgateway'i bir Docker container'ında başlattığınızda bu dosyaya ihtiyacınız olacaktır.edgemicro configkomutunu çalıştırdığınızda döndürülen anahtar ve gizli kimlik bilgilerine sahip olduğunuzdan emin olun. Örneğin:The following credentials are required to start edge micro key: d9c34e1aff68ed969273c016699eabf48780e4f652242e72fc88a43e21252cb0 secret: 3bc95a71c86a3c8ce04537fbcb788158731t51dfc6cdec13b7c05aa0bd969430Edge Microgateway'i bir Docker container'ında başlatmadan önce, kimliği doğrulanmış API proxy çağrıları yapmak için gereken Apigee Edge varlıklarını oluşturmanız (veya oluşturmuş olmanız) gerekir. Bu varlıklar arasında Edge Microgateway uyumlu bir proxy, API ürünü, geliştirici ve geliştirici uygulaması yer alır. Talimatların tamamı için Apigee Edge'de varlık oluşturma başlıklı makaleyi inceleyin.
Edge Micro'yu Docker container'ı olarak çalıştırma
Edge Microgateway için Docker görüntüsünü indirin:
docker pull gcr.io/apigee-microgateway/edgemicro:latest
Sonraki adımlara geçmeden önce Ön koşullar bölümündeki tüm adımları uyguladığınızdan emin olun.
$HOME/.edgemicrokonumundaki Edge Microgateway yapılandırma dosyasını base64 ile kodlamak için aşağıdaki komutu çalıştırın:export EDGEMICRO_CONFIG=`base64 $HOME/.edgemicro/your_org-your_env-config.yaml`
Burada
your_orgveyour_env,edgemicro configkomutunu çalıştırırken kullandığınız kuruluş ve ortamdır.Komutun başına ve sonuna ters tırnak işareti (`) eklemeyi unutmayın. Örneğin:
export EDGEMICRO_CONFIG=`base64 $HOME/.edgemicro/docs-test-config.yaml`
Edge Microgateway'i kapsayıcı olarak çalıştırma Komut, Edge Microgateway'i başlatmak için kapsayıcı çalışma zamanı tarafından kullanılan birkaç ortam değişkeni ayarlar:
chown -R 100:101 ~/.edgemicro/ \ docker run -P -p 8000:8000 -d --name edgemicro \ -v /var/tmp:/opt/apigee/logs \ -e EDGEMICRO_PROCESSES=1 \ -e EDGEMICRO_ORG=your_org \ -e EDGEMICRO_ENV=your_env \ -e EDGEMICRO_KEY=your_key \ -e EDGEMICRO_SECRET=your_secret \ -e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" \ -e "LOG_CONSOLE_OUTPUT_TO_FILE=false" \ -e SERVICE_NAME=edgemicro \ --security-opt=no-new-privileges \ --cap-drop=ALL \ gcr.io/apigee-microgateway/edgemicro:latest
Parametreler
<tr> <td><code>SERVICE_NAME</code></td> <td>If you are on Kubernetes, this parameter is auto-populated. Otherwise, you can set it to anything you wish. If you specify nothing, the service name is set to <code>default</code>.</td> </tr> <tr> <tr> <td><code>DEBUG</code></td> <td>Set to <code>*</code> to enable debugging. </td> </tr> <tr> <td><code>HTTP_PROXY</code> <code>HTTPS_PROXY</code></td> <td>Use when Edge Microgateway is running behind a firewall and the gateway cannot communicate with Apigee Edge. For more information, see <a href="operation-and-configuration-reference-edge-microgateway#settingupedgemicrogatewaybehindacompanyfirewall">Setting up Edge Microgateway behind a company firewall</a>. <p>For example: <code>HTTP_PROXY=http://10.203.0.1:5187/</code></p></td> </tr> <tr> <td><code>NO_PROXY</code></td> <td>A comma delimited list of domains that Edge Microgateway should not proxy to. For more information, see <a href="operation-and-configuration-reference-edge-microgateway#settingupedgemicrogatewaybehindacompanyfirewall">Setting up Edge Microgateway behind a company firewall</a>. <p>For example: <code>localhost,127.0.0.1,localaddress,.localdomain.com</code></p></td> </tr> <tr> <tr> <tr> <td><code>NODE_EXTRA_CA_CERTS</code></td> <td>(Optional) Use this parameter if you are using a CA that's not trusted by default by Node.js. Set the value of this parameter to the path to a file containing one or more trusted certificates in PEM format. For details, see <a href="#tls_certificates">TLS certificates</a>.</td> </tr> <tr> <td><code>--security-opt</code></td> <td>(Optional) Sets desired Docker security options. See <a href="https://docs.docker.com/engine/reference/run/#security-configuration">Security configuration</a> in the Docker documentation.</td> </tr> <tr> <td><code>--cap-drop</code></td> <td>(Optional) Sets limits on Linux capabilities permitted in the container. See <a href="https://docs.docker.com/engine/reference/run/#runtime-privilege-and-linux-capabilities">Runtime privilege and Linux capabilities</a> in the Docker documentation.</td> </tr> </tbody>Parametre Açıklama -PAçık olan tüm bağlantı noktalarını ana makinede yayınlayın. Docker run reference (Docker çalıştırma referansı) başlıklı makaleyi de inceleyin. -pTek bir bağlantı noktasını veya bağlantı noktası aralığını açık bir şekilde eşleyin. Docker run reference (Docker çalıştırma referansı) başlıklı makaleyi de inceleyin. -dBağımsız modda çalıştırın. Docker run reference (Docker çalıştırma referansı) başlıklı makaleyi de inceleyin. -v, -- volumeBir birim bağlama işlemi belirtir. Edge Microgateway'i Docker container'ında TLS kullanacak şekilde yapılandırırsanız günlük dosyası dizinini bağladığınızda 8443 numaralı bağlantı noktasını kullanıma açmanız gerekir. Ayrıca VOLUME [paylaşılan dosya sistemleri] bölümüne de bakın. Docker Container'da TLS kullanma başlıklı makaleyi de inceleyin. -w, -- workdir(İsteğe bağlı) edgemicro.sockveedgemicro.piddosyalarının oluşturulması gereken dizinin yolunu belirtir. Dosya adı kökünü (edgemicro) değiştiremezsiniz. Varsayılan olarak mevcut çalışma dizini yolu kullanılır.Örnek:
docker run -P -p 8000:8000 -d -w /tmp --name edgemicro
...EDGEMICRO_ORGEdge Microgateway'i yapılandırmak için kullandığınız Apigee kuruluşunun adı. EDGEMICRO_ENVEdge Microgateway'i yapılandırmak için kullandığınız Apigee ortamının adı. EDGEMICRO_PROCESSESBaşlatılacak işlem sayısı. EDGEMICRO_KEYEdge Microgateway'i yapılandırırken döndürülen anahtar. EDGEMICRO_SECRETEdge Microgateway'i yapılandırdığınızda döndürülen gizli anahtar. EDGEMICRO_CONFIGBase64 kodlu Edge Microgateway yapılandırma dosyasını içeren bir değişken. LOG_CONSOLE_OUTPUT_TO_FILE(Boole) Günlük çıkışının nereye gönderileceğini belirtmenize olanak tanır. Günlük dosyası seçeneklerini belirtme başlıklı makaleyi inceleyin. Örneğin:
chown -R 100:101 ~/.edgemicro/
docker run -P -p 8000:8000 -d --name edgemicro
-v /var/tmp:/opt/apigee/logs
-e EDGEMICRO_PROCESS=1
-e EDGEMICRO_ORG=docs
-e EDGEMICRO_ENV=test
-e EDGEMICRO_KEY=d9c34e1aff68ed969273b016699eabf48780e4f652242e72fc88a23e21252cb0
-e EDGEMICRO_SECRET=3bc95a71c86a3c8ce04137fbcb788158731t51dfc6cdec13b7c05aa0bd969430
-e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG"
-e SERVICE_NAME=edgemicro
--security-opt=no-new-privileges
--cap-drop=ALL
gcr.io/apigee-microgateway/edgemicroKapsayıcının çalıştığını kontrol etmek için:
docker ps
Şuna benzer bir çıkış alırsınız:
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 8b92e082ea9c edgemicro "/tmp/entrypoint.sh" 12 minutes ago Up 12 minutes 0.0.0.0:8000->8000/tcp, 0.0.0.0:32775->8443/tcp edgemicro
Günlük dosyası çıkış seçeneklerini belirtme
Edge Microgateway yapılandırma parametresi to_console, günlük bilgilerini günlük dosyası yerine standart çıkışa göndermeyi seçmenize olanak tanır. Edge Microgateway'i bir Docker kapsayıcısında çalıştırma adımlarını uygularsanız kapsayıcı, varsayılan olarak stdout ve hata çıkışını kapsayıcıdaki şu konumda bulunan bir dosyaya yönlendirir:
${APIGEE_ROOT}/logs/edgemicro.log.Günlük bilgilerinin
edgemicro.loghizmetine gönderilmesini önlemek için kapsayıcıyı çalıştırırkenLOG_CONSOLE_OUTPUT_TO_FILEdeğişkenini kullanın.Aşağıdaki tabloda,
LOG_CONSOLE_OUTPUT_TO_FILEileto_consolekullandığınızda günlük çıkış davranışı açıklanmaktadır:to_console: trueLOG_CONSOLE_OUTPUT_TO_FILE=false- Günlük dosyalarını yönetme bölümünde açıklandığı gibi, Edge Microgateway günlük dosyasına günlük gönderilmez.
- Günlükler
edgemicro.logdosyasına gönderilmez.
to_console: trueLOG_CONSOLE_OUTPUT_TO_FILE=true- Günlük dosyalarını yönetme bölümünde açıklandığı gibi, Edge Microgateway günlük dosyasına günlük gönderilmez.
- Günlükler
edgemicro.logdosyasına gönderilir.
to_console: falseLOG_CONSOLE_OUTPUT_TO_FILE=true- Günlükler, Günlük dosyalarını yönetme bölümünde açıklandığı gibi Edge Microgateway günlük dosyasına gönderilir.
- Günlükler
edgemicro.logdosyasına gönderilir.
API çağrısını test etme
Edge Microgateway'i container'da başlattıktan sonra API çağrıları yapabilirsiniz. Örneğin, API'nizin temel yolu
/helloise:http://localhost:8000/hello
Örnek çıkış:
{"error":"missing_authorization","error_description":"Missing Authorization header"}Bu yanıtı görürseniz Edge Microgateway, API çağrısını başarıyla işlemiş demektir. Ancak varsayılan olarak Edge Microgateway, kimlik doğrulama için bir API anahtarı gerektirir. Sonraki bölümde, API'yi geçerli bir API anahtarıyla test edeceksiniz.
Geçerli bir API anahtarıyla API'yi test etme
Edge kullanıcı arayüzünde, daha önce oluşturduğunuz geliştirici uygulamasına gidin. Geliştirici Uygulaması sayfasında Tüketici Anahtarı'nı gösterin ve kopyalayın. Bu değer, API anahtarıdır. Kimliği doğrulanmış API çağrıları yapmak için bu anahtarı kullanacaksınız.
API'yi
x-api-keyüstbilgisiyle aşağıdaki gibi çağırın. Geliştirici uygulamasından kopyaladığınız tüketici anahtarı değeri, API anahtarıdır. Varsayılan olarak Edge Microgateway, anahtarıx-api-keyadlı bir üstbilgide şu şekilde iletmenizi bekler:curl -i http://localhost:8000/hello -H "x-api-key:apikey"
Örneğin:
curl -i http://localhost:8000/hello -H "x-api-key:PydUKRDGIXRqF2xh4usn1FLHbhGKVIz"
API anahtarları ve OAuth jetonları ile Edge Microgateway üzerinden kimliği doğrulanmış API çağrıları yapma hakkında daha fazla bilgi edinmek istiyorsanız 4. Bölüm: Edge Microgateway'in Güvenliğini Sağlama başlıklı makaleyi inceleyin.
Edge Microgateway durduruluyor
Edge Microgateway'i durdurmak için aşağıdaki Docker komutunu kullanın:
docker stop edgemicroEdge Microgateway'i yeniden başlatma
Edge Microgateway'i durdurduktan sonra şu Docker komutuyla yeniden başlatabilirsiniz:
docker start edgemicroDocker container'da TLS kullanma
Bu bölümde, Docker container'ında çalışan Edge Microgateway için TLS'nin nasıl yapılandırılacağı açıklanmaktadır. Edge Microgateway sunucusunu, gelen istekler (kuzey yönü) için TLS kullanacak şekilde yapılandırabilirsiniz. Ayrıca Edge Microgateway'i, hedef uç noktalara giden istekler (güney yönü) için TLS istemcisi olacak şekilde yapılandırabilirsiniz.
Sertifika dosyalarının konumu
Edge Microgateway'i çalıştıran Docker container'ının
/opt/apigee/.edgemicroüzerinde bir ekleme noktası vardır. Edge Microgateway'i TLS sertifikaları kullanacak şekilde yapılandırdığınızda sertifika dosyalarını bu ekleme noktasında kullanılabilir hale getirebilir ve Edge Microgateway yapılandırma dosyasında bunlara başvurabilirsiniz. Bu yapılandırma dosyası genellikle$HOME/.edgemicrodizininde bulunur veyour_org-your_env-config.yamlolarak adlandırılır. Örneğin:... edgemicro: ssl: key: /opt/apigee/.edgemicro/southbound/tls.key cert: /opt/apigee/.edgemicro/southbound/tls.crt ...Node.js tarafından güvenilmeyen bir CA kullanma
Node.js tarafından varsayılan olarak güvenilmeyen bir sertifika yetkilisi (CA) kullanıyorsanız (ör. kendinden imzalı sertifika) kapsayıcıyı çalıştırırken
NODE_EXTRA_CA_CERTSparametresini kullanabilirsiniz.Bu parametreyi, PEM biçiminde bir veya daha fazla güvenilir sertifika içeren bir dosyanın yoluna ayarlayın. Bu parametrenin nasıl kullanıldığını görmek için Kuzey yönlü TLS'yi yapılandırma ve Güney yönlü TLS'yi yapılandırma örneklerini inceleyin.
Örneğin:
chown -R 100:101 ~/.edgemicro/ \ docker run -P -p 8443:8443 -d --name edgemicro \ -v $HOME/.edgemicro:/opt/apigee/.edgemicro \ -v $HOME/.edgemicro:/opt/apigee/logs \ -e NODE_EXTRA_CA_CERTS=/opt/apigee/.edgemicro/rootca.pem \ -e EDGEMICRO_PORT=8443 \ -e EDGEMICRO_ORG=docs \ -e EDGEMICRO_ENV=test \ -e EDGEMICRO_KEY=ac36574905fb54fdae65fc5433e831bec2680efb98220a355f2e917e52973c \ -e EDGEMICRO_SECRET=aac81dff6c326eaa222d53c15c8841fa78ea863bf4472568c9ce2d80a3bc56 \ -e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" \ --link helloworld:helloworld gcr.io/apigee-microgateway/edgemicroEdge Micro'yu Docker container'ı olarak çalıştırma başlıklı makaleyi de inceleyin.
TLS doğrulaması devre dışı bırakılıyor
Önerilmese de bazı durumlarda, bir container'da çalışan Edge Microgateway için TLS doğrulamasını devre dışı bırakmak isteyebilirsiniz. TLS'yi devre dışı bırakma özelliği, varsayılan olarak Edge Microgateway Docker kapsayıcısında yerleşik değildir. Görevi tamamlamak için Edge Microgateway için özelleştirilmiş bir Docker görüntüsü oluşturmanız gerekir. Aşağıda, özel görüntüyü oluşturma ve TLS doğrulamasını devre dışı bırakmayla ilgili genel talimatlar verilmiştir.
Edge Microgateway kaynak deposunu
https://github.com/apigee-internal/microgatewayadresinden kopyalayın veya indirin.cd, kaynak kodu dizinindekimicrogateway/kubernetes/docker/edgemicrodizinine kopyalanır.Örneğin:
cd $HOME/git/microgateway/kubernetes/docker/edgemicroentrypoint.shdosyasını açın ve kodu,NODE_TLS_REJECT_UNAUTHORIZEDortam değişkenini kabul edecek şekilde değiştirin. Daha sonra kapsayıcıyı çalıştırdığınızda bu değişken için bir değer belirtirsiniz.Docker container'ı oluşturun:
docker build -t edgemicro .Kapsayıcıyı çalıştırırken
-e NODE_TLS_REJECT_UNAUTHORIZED = 1seçeneğini belirtin. Örneğin:
chown -R 100:101 ~/.edgemicro/ \ docker run -P -p 8443:8443 -d --name edgemicro \ -v $HOME/.edgemicro:/opt/apigee/.edgemicro \ -v $HOME/.edgemicro:/opt/apigee/logs \ -e NODE_TLS_REJECT_UNAUTHORIZED = 1 \ -e EDGEMICRO_PORT=8443 \ -e EDGEMICRO_ORG=docs \ -e EDGEMICRO_ENV=test \ -e EDGEMICRO_KEY=ac36574905fb54fdae65fc5433e831bec2680efb98220a355f2e917e52973c \ -e EDGEMICRO_SECRET=aac81dff6c326eaa222d53c15c8841fa78ea863bf4472568c9ce2d80a3bc56 \ -e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" \ --link helloworld:helloworld gcr.io/apigee-microgateway/edgemicroÖrnek: Kuzey yönlü TLS'yi yapılandırma
Bu bölümde, Edge Microgateway sunucusunda kuzeye giden (gelen) bir TLS bağlantısının nasıl ayarlanacağı açıklanmaktadır. Kuzey yönlü TLS, istemcilerin Edge Microgateway'e API çağrıları yaparken HTTPS kullanmasına olanak tanır. Aşağıdaki örnekte kendinden imzalı sertifikalar kullanılmaktadır.
1. İlk kurulum adımları
- Sisteminizde
openssl.cnfdosyasını bulun. Örneğin,/etc/ssl/openssl.cnf. opensssl.cnfdosyasını düzenlemek için açın.Yapılandırma dosyanızda
req_extensionsbulunduğundan emin olun. Örneğin, dosyanızda aşağıdakine benzer bilgiler olmalıdır:[ req ] ... req_extensions = v3_req ... [ v3_req ] extendedKeyUsage = serverAuth, clientAuth, codeSigning, emailProtection basicConstraints = CA:FALSE keyUsage = nonRepudiation, digitalSignature, keyEnciphermentDoğru SNI özelliklerini oluşturmak için
openssl.cnfdosyasına aşağıdaki bölümü ekleyin:[ alt_names ] DNS.1 = www.example.com DNS.2 = example.com DNS.3 = localhost DNS.4 = localhost.localdomain DNS.5 = 127.0.0.1 DNS.6 = ::1 DNS.7 = fe80::1Örnek
opensssl.cnfdosyası:[ req ] distinguished_name = req_distinguished_name attributes = req_attributes req_extensions = v3_req [ v3_req ] extendedKeyUsage = serverAuth, clientAuth, codeSigning, emailProtection basicConstraints = CA:FALSE keyUsage = nonRepudiation, digitalSignature, keyEncipherment [ req_distinguished_name ] countryName = Country Name (2 letter code) countryName_min = 2 countryName_max = 2 stateOrProvinceName = State or Province Name (full name) localityName = Locality Name (eg, city) 0.organizationName = Organization Name (eg, company) organizationalUnitName = Organizational Unit Name (eg, section) commonName = Common Name (eg, fully qualified host name) commonName_max = 64 emailAddress = Email Address emailAddress_max = 64 [ req_attributes ] challengePassword = A challenge password challengePassword_min = 4 challengePassword_max = 20 [ alt_names ] DNS.1 = www.example.com DNS.2 = example.com DNS.3 = localhost DNS.4 = localhost.localdomain DNS.5 = 127.0.0.1 DNS.6 = ::1 DNS.7 = fe80::1Henüz yapmadıysanız Edge Microgateway'i ilk kullanıma hazırlamak ve yapılandırmak için Ön koşullar bölümündeki adımları uygulayın. Bu adımları tamamladığınızda Edge Microgateway uyumlu bir proxy, API ürünü, geliştirici ve geliştirici uygulaması oluşturmuş olmanız gerekir. Ayrıca
edgemicro configurekomutunu çalıştırmış ve bir anahtar ile gizli anahtar almış olmanız gerekir.
2. Kendinden imzalı sertifikalar oluşturma
Ardından, TLS oluşturmak için ihtiyacınız olan sertifikaları ve anahtarları oluşturun:
$HOME/.edgemicrodizininecd.Aşağıdaki bash komut dosyasını oluşturun. İstediğiniz adı verebilirsiniz. Örneğin:
keygen.sh.#!/bin/bash # generate ca openssl genrsa -out rootca.key 2048 openssl req -x509 -new -nodes -key rootca.key -sha256 -days 1024 -out rootca.pem # generate key openssl genrsa -out tls.key 2048 openssl req -new -key tls.key -out tls.csr # sign cert openssl x509 -req -in tls.csr -CA rootca.pem -CAkey rootca.key -CAcreateserial -out tls.crt -days 1024 -sha256 -extensions 'v3_req' -extfile path/openssl.cnf
Bash dosyasında,
openssl.cnfdosyasının yolunun doğru olduğundan emin olun.Bash dosyasını yürütün. Sertifika bilgileri istenir. Ortak Ad için
localhostkullandığınızdan emin olun.Aşağıdaki dosyaların oluşturulup oluşturulmadığını kontrol edin:
rootca.keyrootca.pemtls.keytls.csrrootca.srltls.crt
3. Edge Microgateway yapılandırma dosyasını düzenleme
Edge Micro yapılandırma dosyasını bir düzenleyicide açın. Örneğin:
vi $HOME/.edgemicro/myorg-test-config.yamledgemicrobölümünü aşağıdaki gibi düzenleyin.portvesslözelliklerinde değişiklik yaptığınızı unutmayın:edge_config: ... edgemicro: port: 8443 max_connections: 1000 config_change_poll_interval: 600 ssl: key: /opt/apigee/.edgemicro/tls.key cert: /opt/apigee/.edgemicro/tls.crt passphrase: admin123 rejectUnauthorized: true requestCert: false logging: ...$HOME/.edgemicrokonumundaki Edge Microgateway yapılandırma dosyasını base64 ile kodlamak için aşağıdaki komutu çalıştırın:export EDGEMICRO_CONFIG=`base64 $HOME/.edgemicro/your_org-your_env-config.yaml`
Burada
your_orgveyour_env,edgemicro configkomutunu çalıştırırken kullandığınız kuruluş ve ortamdır.Komutun başına ve sonuna ters tırnak işareti (`) eklemeyi unutmayın. Örneğin:
export EDGEMICRO_CONFIG=`base64 $HOME/.edgemicro/docs-test-config.yaml`
Edge Micro'yu Docker container'ı olarak çalıştırma başlıklı makaleyi de inceleyin.
4. Kapsayıcıyı çalıştırın
Docker container'ı Edge Microgateway ile çalıştırmak için aşağıdaki komutu yürütün:
chown -R 100:101 ~/.edgemicro/ \ docker run -P -p 8443:8443 -d --name edgemicro \ -v path_to_your_edgemicro_dir:/opt/apigee/.edgemicro \ -v path_to_your_logs_dir:/opt/apigee/logs \ -e NODE_EXTRA_CA_CERTS=/opt/apigee/.edgemicro/rootca.pem \ -e EDGEMICRO_PORT=8443 \ -e EDGEMICRO_ORG=$EDGEMICRO_ORG \ -e EDGEMICRO_ENV=$EDGEMICRO_ENV \ -e EDGEMICRO_KEY=$EDGEMICRO_KEY \ -e EDGEMICRO_SECRET=$EDGEMICRO_SECRET \ -e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" \ gcr.io/apigee-microgateway/edgemicro:latest
Komutta kullanılan aşağıdaki parametrelere dikkat edin. Bu parametreler, Edge Micro'yu Docker container'ı olarak çalıştırma bölümünde açıklanan temel komuttan farklıdır.
port,8443olarak ayarlanmış.- Anahtar ve sertifika dosyalarını bağlamak için bir birim bağlama kullanılır.
NODE_EXTRA_CA_CERTSdeğişkeni, özel bir CA eklemek için kullanılır (kendinden imzalı sertifikalar için gerektiği gibi).
5. TLS yapılandırmasını test etme
Kurulumu test etmek için aşağıdaki cURL komutunu çalıştırın. Komutta temel yolunuzu ve API anahtarınızı değiştirin. Aşağıdaki örnekte,
rootca.pemdosyasının bulunduğu dizinde olduğunuz ve oluşturduğunuz proxy'nin/hellotemel yoluna sahip olduğu varsayılmaktadır:curl -v https://localhost:8443/hello --cacert rootca.pem \ -H "x-api-key: Az82fdnfONVCOOE4NKhajxAboDgA3FAo"Ayrıntılı cURL çıkışı, TLS el sıkışmasının her adımını gösterir. HTTP 200 yanıtı görürseniz yapılandırma başarılı olmuştur:
* Trying ::1...ey:Az82fdnfONVCOOE4NKhajxAboDgA3FAo" * TCP_NODELAY set * Connected to localhost (::1) port 8443 (#0) * ALPN, offering h2 * ALPN, offering http/1.1 * Cipher selection: ALL:!EXPORT:!EXPORT40:!EXPORT56:!aNULL:!LOW:!RC4:@STRENGTH * successfully set certificate verify locations: * CAfile: rootca.pem CApath: none * TLSv1.2 (OUT), TLS handshake, Client hello (1): * TLSv1.2 (IN), TLS handshake, Server hello (2): * TLSv1.2 (IN), TLS handshake, Certificate (11): * TLSv1.2 (IN), TLS handshake, Server key exchange (12): * TLSv1.2 (IN), TLS handshake, Server finished (14): * TLSv1.2 (OUT), TLS handshake, Client key exchange (16): * TLSv1.2 (OUT), TLS change cipher, Client hello (1): * TLSv1.2 (OUT), TLS handshake, Finished (20): * TLSv1.2 (IN), TLS change cipher, Client hello (1): * TLSv1.2 (IN), TLS handshake, Finished (20): * SSL connection using TLSv1.2 / ECDHE-RSA-AES128-GCM-SHA256 * ALPN, server accepted to use http/1.1 * Server certificate: * subject: C=US; ST=CO; L=Boulder; O=Docs; OU=Docs; CN=localhost; emailAddress=docs@apigee.com * start date: Dec 14 22:35:28 2018 GMT * expire date: Oct 3 22:35:28 2021 GMT * common name: localhost (matched) * issuer: C=US; ST=CO; L=Boulder; O=Docs; OU=Docs; CN=localhost; emailAddress=docs@apigee.com * SSL certificate verify ok. > GET /hello HTTP/1.1 > Host: localhost:8443 > User-Agent: curl/7.54.0 > Accept: */* > x-api-key:Az82fdnfaONVCOE4NKhajxAboDA3FAo > < HTTP/1.1 200 OK < x-powered-by: Apigee < access-control-allow-origin: * < x-frame-options: ALLOW-FROM RESOURCE-URL < x-xss-protection: 1 < x-content-type-options: nosniff < content-type: text/plain; charset=utf-8 < etag: W/"d-GHB1ZrJKk/wdVTdB/jgBsw" < date: Fri, 14 Dec 2018 22:43:13 GMT < via: 1.1 google < alt-svc: clear < x-response-time: 1325 < Connection: keep-alive < Transfer-Encoding: chunked < * Connection #0 to host localhost left intact Hello, Guest!
Örnek: Güney yönlü TLS'yi yapılandırma
Bu bölümde, Edge Microgateway sunucusu ile arka uç hedef uygulaması arasında güney yönlü (giden) bir TLS bağlantısının nasıl kurulacağı açıklanmaktadır. Aşağıdaki örnekte kendinden imzalı sertifikalar kullanılmaktadır.
1. İlk kurulum adımları
- Sisteminizde
openssl.cnfdosyasını bulun. Örneğin,/etc/ssl/openssl.cnf. opensssl.cnfdosyasını düzenlemek için açın.Yapılandırma dosyanızda
req_extensionsbulunduğundan emin olun. Örneğin, dosyanızda aşağıdakine benzer bilgiler olmalıdır:[ req ] ... req_extensions = v3_req ... [ v3_req ] extendedKeyUsage = serverAuth, clientAuth, codeSigning, emailProtection basicConstraints = CA:FALSE keyUsage = nonRepudiation, digitalSignature, keyEnciphermentDoğru SNI özelliklerini oluşturmak için
openssl.cnfdosyasına aşağıdaki bölümü ekleyin:[ alt_names ] DNS.1 = helloworld DNS.2 = localhost DNS.3 = localhost.localdomain DNS.4 = 127.0.0.1 DNS.5 = ::1 DNS.6 = fe80::1Örnek
opensssl.cnfdosyası:[ req ] distinguished_name = req_distinguished_name attributes = req_attributes req_extensions = v3_req [ v3_req ] extendedKeyUsage = serverAuth, clientAuth, codeSigning, emailProtection basicConstraints = CA:FALSE keyUsage = nonRepudiation, digitalSignature, keyEncipherment [ req_distinguished_name ] countryName = Country Name (2 letter code) countryName_min = 2 countryName_max = 2 stateOrProvinceName = State or Province Name (full name) localityName = Locality Name (eg, city) 0.organizationName = Organization Name (eg, company) organizationalUnitName = Organizational Unit Name (eg, section) commonName = Common Name (eg, fully qualified host name) commonName_max = 64 emailAddress = Email Address emailAddress_max = 64 [ req_attributes ] challengePassword = A challenge password challengePassword_min = 4 challengePassword_max = 20 [ alt_names ] DNS.1 = helloworld DNS.2 = localhost DNS.3 = localhost.localdomain DNS.4 = 127.0.0.1 DNS.5 = ::1 DNS.6 = fe80::1edgemicro configurekomutunu çalıştırın:edgemicro configure -o your_org -e your_env -u your_username
Yapılandırma hakkında daha fazla bilgi için 1. Bölüm: Edge Microgateway'i yapılandırma başlıklı makaleyi inceleyin.
edgemicro configuretarafından döndürülen anahtar ve gizli kimlik bilgilerini kopyalayın. Kapsayıcıyı çalıştırmak için bu değerlere ihtiyacınız olacaktır. Örneğin:The following credentials are required to start edge micro key: d9c34e1aff68ed969273c016699eabf48780e4f652242e72fc88a43e21252cb0 secret: 3bc95a71c86a3c8ce04537fbcb788158731t51dfc6cdec13b7c05aa0bd969430
2. Node.js hedef uygulaması oluşturma
.edgemicrodizininecd.Aşağıdaki bash komut dosyasını oluşturun. İstediğiniz adı verebilirsiniz. Örneğin:
keygen.sh.#!/bin/bash # generate ca openssl genrsa -out rootca.key 2048 openssl req -x509 -new -nodes -key rootca.key -sha256 -days 1024 -out rootca.pem # generate key openssl genrsa -out tls.key 2048 openssl req -new -key tls.key -out tls.csr # sign cert openssl x509 -req -in tls.csr -CA rootca.pem -CAkey rootca.key -CAcreateserial -out tls.crt -days 1024 -sha256 -extensions 'v3_req' -extfile path/openssl.cnf
Bash dosyasında,
openssl.cnfdosyasının yolunun doğru olduğundan emin olun.Bash dosyasını yürütün. Sertifika bilgileri istenir. Ortak Ad için
hellworldkullandığınızdan emin olun.Aşağıdaki dosyaların oluşturulup oluşturulmadığını kontrol edin:
rootca.keyrootca.pemtls.keytls.csrrootca.srltls.crt
server.jsadlı yeni bir dosya oluşturun.'use strict'; const express = require('express'); const https = require('https'); const fs = require('fs'); const options = { key: fs.readFileSync("tls.key"), cert: fs.readFileSync("tls.crt") }; // Constants const PORT = 9443; const HOST = '0.0.0.0'; // App const app = express(); app.get('/', (req, res) => { res.send('Hello world\n'); }); https.createServer(options, app).listen(PORT);server.jsile aynı dizinde birpackage.jsondosyası oluşturun. Örneğin:{ "name": "helloworld", "version": "1.0.0", "description": "", "main": "server.js", "scripts": { "test": "echo \"Error: no test specified\" && exit 1", "start": "node server.js" }, "author": "", "license": "ISC", "dependencies": { "express": "^4.16.4", "fs": "0.0.1-security", "https": "^1.0.0" } }Bağımlılıkları almak için
npm installkomutunu çalıştırın.server.jsile aynı dizinde yeni bir Dockerfile oluşturun.WORKDIR, Node.js uygulamanızın kök dizininin yoludur:FROM node:8-alpine WORKDIR path-to-your-node-app COPY package*.json ./ RUN npm install COPY . . EXPOSE 9443 CMD [ "npm", "start" ]
Docker görüntüsünü oluşturun:
docker build -t helloworld .Örnek uygulamayı başlatın:
docker run -P -p 9443:9443 --name helloworld helloworld
3. Apigee Edge'de varlık oluşturma
Bu ayarlarla Edge Microgateway uyumlu bir proxy oluşturun. Daha fazla bilgi için Edge'de Edge Microgateway uyumlu bir API proxy'si oluşturma başlıklı makaleyi inceleyin.
- Proxy adı:
edgemicro_local - Düzeltme:
1 - Temel yol:
/local - Hedef:
https://helloworld:9443
- Proxy adı:
API ürünü oluşturma Ayrıntılar için Ürün oluşturma başlıklı makaleyi inceleyin.
Geliştirici oluşturun. Ayrıntılar için Geliştirici oluşturma başlıklı makaleyi inceleyin.
Geliştirici uygulaması oluşturun. Ayrıntılar için Geliştirici uygulaması oluşturma başlıklı makaleyi inceleyin.
4. Kapsayıcıyı çalıştırın
Edge Micro yapılandırma dosyasını bir düzenleyicide açın. Örneğin:
vi $HOME/.edgemicro/myorg-test-config.yamledgemicrobölümünü aşağıdaki gibi düzenleyin.portvesslözelliklerinde değişiklik yaptığınızı unutmayın:edge_config: ... edgemicro: port: 8443 max_connections: 1000 config_change_poll_interval: 600 ssl: key: /opt/apigee/.edgemicro/tls.key cert: /opt/apigee/.edgemicro/tls.crt passphrase: admin123 rejectUnauthorized: true requestCert: false logging: ...$HOME/.edgemicrokonumundaki Edge Microgateway yapılandırma dosyasını base64 olarak kodlamak için aşağıdaki komutu çalıştırın:export EDGEMICRO_CONFIG=`base64 $HOME/.edgemicro/your_org-your_env-config.yaml`
Burada
your_orgveyour_env,edgemicro configkomutunu çalıştırırken kullandığınız kuruluş ve ortamdır.Komutun başına ve sonuna ters tırnak işareti (`) eklemeyi unutmayın. Örneğin:
export EDGEMICRO_CONFIG=`base64 $HOME/.edgemicro/docs-test-config.yaml`
Edge Microgateway'i Docker container'ında başlatmak için aşağıdaki komutu çalıştırın.
chown -R 100:101 ~/.edgemicro/ \ docker run -P -p 8443:8443 -d --name edgemicro \ -v path_to_your_edgemicro_dir:/opt/apigee/.edgemicro \ -v path_to_your_logs_dir:/opt/apigee/logs \ -e EDGEMICRO_PORT=8443 \ -e EDGEMICRO_ORG=$EDGEMICRO_ORG \ -e EDGEMICRO_ENV=$EDGEMICRO_ENV \ -e EDGEMICRO_KEY=$EDGEMICRO_KEY \ -e EDGEMICRO_SECRET=$EDGEMICRO_SECRET \ -e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" \ --link helloworld:helloworld gcr.io/apigee-microgateway/edgemicro
5. TLS yapılandırmasını test etme
Kurulumu test etmek için aşağıdaki cURL komutunu çalıştırın. Microgateway uyumlu proxy'de kullandığınız temel yolu ve Apigee Edge'de oluşturduğunuz geliştirici uygulamasından aldığınız API anahtarını değiştirin. Örneğin:
curl https://localhost:8443/local -k -H "x-api-key: xxxx" -vŞu hatayı görürsünüz:
... * subject: C=CA; ST=Ontario; L=Toronto; O=Google Canada; OU=Google Cloud Platform; CN=edgemicro; emailAddress=srinandans@google.com * start date: Dec 10 02:12:22 2018 GMT * expire date: Sep 29 02:12:22 2021 GMT * issuer: C=CA; ST=Ontario; L=Toronto; O=Google Canada; OU=Google Cloud Platform; CN=edgemicro; emailAddress=srinandans@google.com * SSL certificate verify result: unable to get local issuer certificate (20), continuing anyway. > GET /local HTTP/1.1 > Host: localhost:8443 > User-Agent: curl/7.54.0 > Accept: */* > x-api-key: 9fVC65pFj8LrmlPmVyxFjx4KgAHTxqSd > < HTTP/1.1 502 Bad Gateway < Date: Wed, 12 Dec 2018 05:25:01 GMT < Connection: keep-alive < Content-Length: 93 < * Connection #0 to host localhost left intact {"message":"unable to verify the first certificate","code":"UNABLE_TO_VERIFY_LEAF_SIGNATURE"}Edge Microgateway'i yeniden çalıştırın ancak bu kez
NODE_EXTRA_CA_CERTSdeğişkenini ekleyin.chown -R 100:101 ~/.edgemicro/ \ docker run -P -p 8443:8443 -d --name edgemicro \ -v path_to_your_edgemicro_dir:/opt/apigee/.edgemicro \ -v path_to_your_logs_dir:/opt/apigee/logs \ -e NODE_EXTRA_CA_CERTS=/opt/apigee/.edgemicro/rootca.pem \ -e EDGEMICRO_PORT=8443 \ -e EDGEMICRO_ORG=$EDGEMICRO_ORG \ -e EDGEMICRO_ENV=$EDGEMICRO_ENV \ -e EDGEMICRO_KEY=$EDGEMICRO_KEY \ -e EDGEMICRO_SECRET=$EDGEMICRO_SECRET \ -e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" \ --link helloworld:helloworld gcr.io/apigee-microgateway/edgemicro
Aşağıdaki cURL komutunu çalıştırın. Temel yolunuzu ve API anahtarınızı daha önce yaptığınız gibi değiştirin. Örneğin:
curl https://localhost:8443/local -k -H "x-api-key: xxxx" -vÇıkışı kontrol edin. İşlem başarılı olursa HTTP 200 durum yanıtı alırsınız:
... > GET /local HTTP/1.1 > Host: localhost:8443 > User-Agent: curl/7.54.0 > Accept: */* > x-api-key: 9fVC65pFj8LrmlPmVyxFjx4KgAHTxqSd > < HTTP/1.1 200 OK < x-powered-by: Express < content-type: text/html; charset=utf-8 < etag: W/"c-M6tWOb/Y57lesdjQuHeB1P/qTV0" < date: Wed, 12 Dec 2018 05:49:28 GMT < x-response-time: 421 < Connection: keep-alive < Transfer-Encoding: chunked < Hello world
Özel eklenti ekleme
Özel eklentiler yazarak mikro ağ geçidine yeni özellikler ve işlevler ekleyebilirsiniz. Özel eklentiler, mikro ağ geçidinden geçen istek ve yanıtlarla programatik olarak etkileşim kurmanıza olanak tanır.
Docker container'da çalışan bir Edge Microgateway örneğine eklenti dağıtmak için iki seçeneğiniz vardır:
Bu bölümün geri kalanında, standart bir Edge Microgateway kurulumu için eklenti yazma ve yapılandırma konusunda bilgi sahibi olduğunuz varsayılmaktadır. Aksi takdirde Özel eklentiler geliştirme başlıklı makaleyi inceleyin.
A seçeneği: Eklenti dizinini bir birime bağlama
(2.5.27 sürümünde eklendi) Birim bağlama yoluyla eklenti ekleme adımları, Edge Microgateway'e özel eklenti eklemek için gereken adımlara benzer. Docker kapsayıcısını çalıştırdığınızda, yerel sisteminizdeki (birim) eklenti dizinini kapsayıcı ekleme noktasına (
/opt/apigee/plugins) ekleyebilirsiniz. Ardından, Edge Microgateway yapılandırma dosyasında yerel birim dizinini belirtirsiniz.Aşağıdaki adımlarda, özel eklentileri dahil etmek için Docker ekleme noktasının nasıl kullanılacağı gösterilmektedir.
Edge Microgateway'i durdurma:
edgemicro stopÖzel eklentileriniz için bir dizin oluşturun. Örneğin,
$HOME/edgemicro/custom/pluginsÖzel eklenti dizinini Edge Microgateway yapılandırma dosyasına ekleyin. Örneğin:
plugins: dir: $HOME/edgemicro/custom/plugins sequence: - oauth - response-uppercase ````Basit bir eklenti yazma bölümündeki talimatlara göre eklentinizi yazıp test edin. Eklenti kodunuzu doğru dizin yapısına yerleştirdiğinizden emin olun. Örneğin:
custom | |-- plugins | |- response-uppercase | |- index.js | |- package.json |- request-headers | | - index.js | - package.jsonDocker container'ını aşağıdaki gibi bir komutla çalıştırın. Bu komutta, eklenti dizinini Docker birimine bağlamak için
-vseçeneğini kullanırsınız. Aşağıdaki örnek komutta, eklentiler dizini$HOME/edgemicro/custom/plugins(özel eklentinin bulunduğu yer), kapsayıcının ekleme noktasıyla/opt/apigee/pluginseşlenir:chown -R 100:101 ~/.edgemicro/ \ docker run -P -p 8000:8000 -d --name edgemicro \ -v /var/tmp:/opt/apigee/logs \ -v $HOME/edgemicro/custom/plugins:/opt/apigee/plugins \ -e EDGEMICRO_PROCESSES=1 \ -e EDGEMICRO_ORG=jdoe \ -e EDGEMICRO_ENV=test \ -e EDGEMICRO_KEY=39c4b561100cd7f258768d1072f3e1d7c17b5f36a18fe89972bb5c9ce7e58fb \ -e EDGEMICRO_SECRET=f5f9e239a38b4e6cc99c2aa067716a84aebdcff9580a7925fc500e402b1a5fa \ -e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" \ -e SERVICE_NAME=edgemicro \ --security-opt=no-new-privileges \ --cap-drop=ALL gcr.io/apigee-microgateway/edgemicro:latestEklentiyi test etmek için API'nizi çağırın.
Daha fazla bilgi için VOLUME [paylaşılan dosya sistemleri] bölümüne bakın.
B seçeneği: Eklentileri container'da derleme
Bu seçenekte, eklentileri kapsayıcınıza yerleştirirsiniz.
1. Eklentilerinizi paketleme
Basit bir eklenti yazma bölümündeki talimatlara göre eklentinizi yazıp test edin.
Eklenti kodunuzu uygun dizin yapısına yerleştirin. Eklenti dizinleri belirli bir yapıya uymalıdır. Aşağıdaki örnekte, izlemeniz gereken yapı gösterilmektedir. Burada
response-uppercaseverequest-headers, özel eklenti kodunu içeren klasörlerin adlarıdır (bu adlar yalnızca örnektir, klasör adlarınız farklı olabilir):plugin | |-- plugins | |- response-uppercase | |- index.js | |- package.json |- request-headers | | - index.js | - package.jsoncd,pluginklasörüne taşındı.pluginklasöründe,pluginsklasörünün tamamını sıkıştırın:zip -r plugins.zip plugins/
2. Docker görüntüsü oluşturma
Ardından, eklenti kodunuzu bir Edge Microgateway görüntüsüne eklemek için bir Dockerfile oluşturun.
- ZIP dosyasının bulunduğu dizinde
Dockerfileadlı yeni bir dosya oluşturun. Aşağıdaki kodu
Dockerfiledosyasına ekleyin ve dosyayı kaydedin:FROM gcr.io/apigee-microgateway/edgemicro:latest USER root RUN apt-get update && \ apt-get install -y unzip && \ rm -rf /var/lib/apt/lists/* && \ mkdir /opt/apigee/customplugins && \ chown apigee:apigee /opt/apigee/customplugins COPY plugins.zip /opt/apigee/customplugins RUN su - apigee -c "unzip /opt/apigee/customplugins/plugins.zip -d /opt/apigee/customplugins" EXPOSE 8000 EXPOSE 8443 USER apigee ENTRYPOINT ["/opt/apigee/entrypoint.sh"]Eklentilerinizle yeni bir Edge Microgateway Docker görüntüsü oluşturun:
docker build -t image-name .Örneğin:
docker build -t edgemicroplugins .
3. Edge Microgateway yapılandırmasını güncelleme
Eklentiler paketlendiğine göre bunları Edge Microgateway yapılandırma dosyasına eklemeniz gerekir.
Edge Microgateway yapılandırma dosyasını bir düzenleyicide açın:
$HOME/.edgemicro/org-env-config.yaml
Örneğin:
vi $HOME/.edgemicro/myorg-test-config.yaml
Eklenti dizinini yapılandırma dosyasına ekleyin. Aşağıdaki örnekte
dirözelliği, eklenti kodunun konumunu (Dockerfile'da belirttiğiniz) belirtir. Ayrıca, eklenti dizininin adını da belirtmeniz gerekir. Aşağıdaki örnekte bu adresponse-uppercaseşeklindedir.edgemicro: ... plugins: dir: /opt/apigee/plugins sequence: - oauth - response-uppercase
4. Mikro ağ geçidini başlatma
Son olarak, container'da microgateway'i başlatmanız gerekir.
$HOME/.edgemicrokonumundaki Edge Microgateway yapılandırma dosyasını base64 ile kodlamak için aşağıdaki komutu çalıştırın:export EDGEMICRO_CONFIG=`base64 $HOME/.edgemicro/your_org-your_env-config.yaml`
Burada
your_orgveyour_env,edgemicro configkomutunu çalıştırırken kullandığınız kuruluş ve ortamdır.Komutun başına ve sonuna ters tırnak işareti (`) eklemeyi unutmayın. Örneğin:
export EDGEMICRO_CONFIG=`base64 $HOME/.edgemicro/docs-test-config.yaml`
Edge Microgateway'i kapsayıcı olarak çalıştırma Komut, Edge Microgateway'i başlatmak için kapsayıcı çalışma zamanı tarafından kullanılan birkaç ortam değişkeni ayarlar:
docker run -P -p 8000:8000 -d --name edgemicroplugins \ -e EDGEMICRO_PLUGIN_DIR=/opt/apigee/customplugins/plugins \ -e EDGEMICRO_ORG=your_org \ -e EDGEMICRO_ENV=your_env \ -e EDGEMICRO_KEY=your_key \ -e EDGEMICRO_SECRET=your_secret \ -e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" \ -e SERVICE_NAME=edgemicroplugins image_name
Örneğin:
docker run -P -p 8000:8000 -d --name edgemicroplugins \ -e EDGEMICRO_PLUGIN_DIR=/opt/apigee/customplugins/plugins \ -e EDGEMICRO_ORG=docs \ -e EDGEMICRO_ENV=test \ -e EDGEMICRO_KEY=d9c34e1aff68ed969273b016699eabf48780e4f652242e72fc88a23e21252cb0 \ -e EDGEMICRO_SECRET=3bc95a71c86a3c8ce04137fbcb788158731t51dfc6cdec13b7c05aa0bd969430 \ -e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" \ -e SERVICE_NAME=edgemicroplugins edgemicroplugins
Eklentiyi test etmek için API'nizi çağırın:
API'nizi çağırarak ve çıkışın beklendiği gibi olduğunu doğrulayarak eklenti kodunun yürütüldüğünü test edin:
curl -i http://localhost:8000/hello -H "x-api-key:apikey"
Örneğin,
response-uppercaseeklentisi şöyle bir yanıt döndürebilir:curl -i http://localhost:8000/hello -H "x-api-key:PydUKRDGIXRqF2xh4usn1FLHbhGKVIz" HELLO, WORLD!