Anda sedang melihat dokumentasi Apigee Edge.
Buka
dokumentasi Apigee X. info
UnresolvedVariable
Kode error
steps.basicauthentication.UnresolvedVariable
Isi respons error
{
"fault": {
"faultstring": "Unresolved variable : [variable_name]",
"detail": {
"errorcode": "steps.basicauthentication.UnresolvedVariable"
}
}
}
Contoh Pesan Error
{
"fault": {
"faultstring": "Unresolved variable : request.header.Authorization",
"detail": {
"errorcode": "steps.basicauthentication.UnresolvedVariable"
}
}
}
Penyebab
Error ini terjadi jika variabel yang berisi string berenkode Base64 yang ditentukan dalam elemen <Source>
dari kebijakan BasicAuthentication adalah:
- Di luar cakupan (tidak tersedia di alur spesifik tempat kebijakan sedang dijalankan)
- Tidak dapat diselesaikan (tidak ditentukan)
Misalnya, error ini terjadi jika kebijakan BasicAuthentication memiliki variabel yang ditentukan sebagai request.header.Authorization
dalam elemen <Source>
, tetapi header Otorisasi tidak diteruskan sebagai bagian dari permintaan API.
Diagnosis
Identifikasi variabel yang digunakan untuk elemen
<Source>
dalam kebijakan BasicAuthentication. Anda dapat menemukan informasi ini dalam elemenfaultstring
respons error. Misalnya, dalamfaultstring,
berikut, variabel yang digunakan untuk elemen<Source>
adalahrequest.header.Authorization
:"faultstring": "Unresolved variable : request.header.Authorization"
Periksa semua kebijakan BasicAuthentication di Proxy API tertentu tempat kegagalan terjadi. Mungkin ada satu atau beberapa kebijakan BasicAuthentication. Identifikasi kebijakan atau kebijakan BasicAuthentication tertentu yang variabelnya ditentukan dalam elemen
<Source>
cocok dengan nama variabel yang diidentifikasi dalam string kesalahan (langkah #1 di atas).Misalnya, kebijakan berikut menetapkan elemen
<Source>
ke variabel bernamarequest.header.Authorization
, yang cocok dengan yang ada difaultstring
:<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <BasicAuthentication name="DecodeBaseAuthHeaders"> <DisplayName>Decode Basic Authentication Header</DisplayName> <Operation>Decode</Operation> <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables> <User ref="request.header.username"/> <Password ref="request.header.password"/> <Source>request.header.Authorization</Source> </BasicAuthentication>
Menentukan apakah variabel telah ditetapkan dan tersedia di alur tempat kebijakan BasicAuthentication dijalankan.
Jika variabelnya adalah:
- Di luar cakupan (tidak tersedia di alur spesifik tempat kebijakan sedang dijalankan)
- Tidak dapat diselesaikan (tidak ditentukan)
Itulah sebabnya terjadinya error.
Pada contoh kebijakan BasicAuthentication yang ditampilkan di atas, variabel
request.header.Authorization
tidak diteruskan sebagai bagian dari permintaan. Artinya, permintaan API dibuat tanpa header Otorisasi seperti yang ditunjukkan di bawah ini:curl -v "http://org-env.apigee.net/basicauth"
Karena variabel yang digunakan dalam kebijakan BasicAuthentication tidak tersedia, Anda akan menerima kode error:
steps.basicauthentication.UnresolvedVariable
Resolusi
Pastikan variabel yang digunakan dalam kebijakan BasicAuthentication ditetapkan atau diteruskan sebagai input dan tersedia dalam alur tempat kebijakan dijalankan.
Untuk memperbaiki masalah pada contoh kebijakan BasicAuthentication yang dibahas di atas, buat permintaan API seperti yang ditunjukkan di bawah:
curl -v "http://org-env.apigee.net/basicauth" -H "Authorization: Basic YWthc2g6MTIz"
InvalidBasicAuthenticationSource
Kode error
steps.basicauthentication.InvalidBasicAuthenticationSource
Isi respons error
{
"fault": {
"faultstring": "Source variable : [variable_name] for basic authentication decode policy is not valid",
"detail": {
"errorcode": "steps.basicauthentication.InvalidBasicAuthenticationSource"
}
}
}
Contoh Error Pesan
{
"fault": {
"faultstring": "Source variable : request.header.Authorization for basic authentication decode policy is not valid",
"detail": {
"errorcode": "steps.basicauthentication.InvalidBasicAuthenticationSource"
}
}
}
Kemungkinan penyebab
Kemungkinan penyebab error ini adalah:
Penyebab | Deskripsi |
---|---|
Variabel sumber tidak valid | Variabel sumber input ke Kebijakan BasicAuthentication bukan string berenkode Base64 yang valid. |
Header Salah | Format header yang berisi string berenkode Base64 yang diteruskan ke kebijakan BasicAuthentication salah. |
Penyebab: Variabel sumber tidak valid
Error ini terjadi jika variabel yang berisi string berenkode Base64 yang ditentukan dalam elemen <Source>
pada kebijakan BasicAuthentication tidak berisi nilai yang valid.
Misalnya, error ini terjadi jika variabel yang ditentukan dalam elemen <Source>
kebijakan BasicAuthentication tidak memiliki string berenkode Base64 yang valid.
Diagnosis
Identifikasi variabel yang digunakan untuk elemen
<Source>
dalam kebijakan BasicAuthentication. Anda dapat menemukan informasi ini dalam elemenfaultstring
respons error. Misalnya, dalamfaultstring,
berikut, variabel yang digunakan untuk elemen<Source>
adalahrequest.header.Authorization
:"faultstring": "Source variable : request.header.Authorization for basic authentication decode policy is not valid"
Periksa semua kebijakan BasicAuthentication di Proxy API tertentu tempat kegagalan terjadi. Mungkin ada satu atau beberapa kebijakan BasicAuthentication. Identifikasi kebijakan BasicAuthentication (ies) tertentu yang mana variabel yang ditentukan dalam elemen
<Source>
cocok dengan nama variabel yang diidentifikasi dalam string kesalahan (langkah #1 di atas).Misalnya, kebijakan berikut menetapkan elemen
<Source>
ke variabel bernamarequest.header.Authorization
, yang cocok dengan yang ada difaultstring
:<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <BasicAuthentication name="DecodeBaseAuthHeaders"> <DisplayName>Decode Basic Authentication Header</DisplayName> <Operation>Decode</Operation> <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables> <User ref="request.header.username"/> <Password ref="request.header.password"/> <Source>request.header.Authorization</Source> </BasicAuthentication>
Jika nilai yang disimpan dalam variabel yang ditentukan dalam elemen
<Source>
bukan string berenkode Base64 yang valid,itulah penyebab error.
Pada contoh kebijakan BasicAuthentication yang ditampilkan di atas, variabel
request.header.Authorization
yang dikirim oleh klien sebagai header tidak valid seperti yang ditunjukkan di bawah ini:curl -v "http://org-env.apigee.net/basicauth" -H "Authorization: Basic 23435"
Karena variabel
request.header.Authorization
memiliki string berenkode Base64 "23435"
yang tidak valid, Anda menerima kode error:steps.basicauthentication.InvalidBasicAuthenticationSource
Resolusi
Pastikan variabel yang ditentukan untuk elemen <Source>
dalam kebijakan BasicAuthentication memiliki string berenkode Base64 yang valid.
Untuk memperbaiki masalah pada contoh kebijakan BasicAuthentication yang dibahas di atas, buat permintaan API dengan meneruskan string berenkode Base64 yang valid di header Otorisasi seperti yang ditunjukkan di bawah ini:
curl -v "http://org-env.apigee.net/basicauth" -H "Authorization: Basic YWthc2g6MTIz"
Penyebab: Header salah/tidak valid
Error ini terjadi jika header yang diteruskan ke kebijakan BasicAuthentication salah format atau tidak valid.
Misalnya, error ini terjadi jika kebijakan BasicAuthentication memiliki variabel yang ditentukan sebagai request.header.Authorization
dalam elemen <Source>
dan header yang diteruskan sebagai bagian dari permintaan API memiliki format yang salah/tidak valid.
Diagnosis
Identifikasi variabel yang digunakan untuk elemen
<Source>
dalam kebijakan BasicAuthentication. Anda dapat menemukan informasi ini dalam elemenfaultstring
respons error. Misalnya, dalam error berikut, variabel yang digunakan untuk elemen<Source>
adalahrequest.header.Authorization
:"faultstring": "Source variable : request.header.Authorization for basic authentication decode policy is not valid"
Periksa semua kebijakan BasicAuthentication di Proxy API tertentu tempat kegagalan terjadi. Mungkin ada satu atau beberapa kebijakan BasicAuthentication. Identifikasi kebijakan BasicAuthentication (ies) tertentu yang mana variabel yang ditentukan dalam elemen
<Source>
cocok dengan nama variabel yang diidentifikasi dalam string kesalahan (langkah #1 di atas).Misalnya, kebijakan berikut menetapkan elemen
<Source>
ke variabel bernamarequest.header.Authorization
, yang cocok dengan yang ada difaultstring
:<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <BasicAuthentication name="DecodeBaseAuthHeaders"> <DisplayName>Decode Basic Authentication Header</DisplayName> <Operation>Decode</Operation> <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables> <User ref="request.header.username"/> <Password ref="request.header.password"/> <Source>request.header.Authorization</Source> </BasicAuthentication>
Jika variabel adalah header dan formatnya salah atau tidak valid, yaitu tidak memiliki jenis autentikasi atau jika jenis autentikasinya bukan "Dasar", maka itulah penyebab error.
Header Otorisasi adalah bentuk berikut:
Authorization: <Authentication type> <credentials>
Header yang salah format dapat diteruskan ke kebijakan BasicAuthentication dengan dua cara:
Contoh 1: Tidak ada jenis Autentikasi di Header:
curl -v "http://org-env.apigee.net/basicauth" -H "Authorization: YWthc2g6MTIz"
Pada contoh di atas, header Authorization tidak memiliki jenis Authentication. Jika header ini diteruskan ke kebijakan BasicAuthentication yang ditampilkan di atas, Anda akan menerima kode error:
steps.basicauthentication.InvalidBasicAuthenticationSource
Contoh 2: Jenis autentikasi bukan jenis "Dasar":
curl -v "http://org-env.apigee.net/basicauth" -H "Authorization: OAuth YWthc2g6MTIz"
Pada contoh di atas, header Otorisasi tidak memiliki jenis Autentikasi "Dasar". Jika diteruskan ke kebijakan BasicAuthentication yang ditampilkan di atas, Anda akan menerima kode error:
steps.basicauthentication.InvalidBasicAuthenticationSource
Demikian pula, error ini juga dapat terjadi jika jenis Authentication seperti Bearer, Digest Auth, dll. digunakan di header Authorization.
Resolusi
Pastikan header yang digunakan untuk meneruskan input ke kebijakan BasicAuthentication memiliki jenis Authentication dan berjenis "Basic".
Untuk memperbaiki masalah pada contoh kebijakan BasicAuthentication yang dibahas di atas, buat permintaan API dengan meneruskan string berenkode Base64 yang valid dengan jenis Autentikasi "Dasar" di header Otorisasi seperti yang ditunjukkan di bawah:
curl -v "http://org-env.apigee.net/basicauth" -H "Authorization: Basic YWthc2g6MTIz"