पुष्टि करने की बुनियादी नीति

Apigee Edge दस्तावेज़ देखा जा रहा है.
Apigee X दस्तावेज़ पर जाएं. जानकारी

यह क्या है

इससे आपको लास्ट मील सुरक्षा के लिए, कम बुनियादी पुष्टि करने का इस्तेमाल करने की सुविधा मिलती है. इस नीति के लिए उपयोगकर्ता नाम और पासवर्ड इस्तेमाल किए जाते हैं, Base64 उन्हें कोड में बदलता है, और नतीजे के तौर पर मिली वैल्यू को एक वैरिएबल में लिख देता है. नतीजे के तौर पर मिलने वाली वैल्यू Basic Base64EncodedString फ़ॉर्मैट में है. आम तौर पर, इस वैल्यू को एचटीटीपी हेडर पर लिखा जाता है, जैसे कि ऑथराइज़ेशन हेडर.

इस नीति की मदद से, Base64 कोड में बदली गई स्ट्रिंग में सेव किए गए क्रेडेंशियल को उपयोगकर्ता नाम और पासवर्ड में डिकोड करने की सुविधा भी मिलती है.

सैंपल

<BasicAuthentication name="ApplyBasicAuthHeader">
   <DisplayName>ApplyBasicAuthHeader</DisplayName>
   <Operation>Encode</Operation>
   <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
   <User ref="BasicAuth.credentials.username" />
   <Password ref="BasicAuth.credentials.password" />
   <AssignTo createNew="false">request.header.Authorization</AssignTo>
</BasicAuthentication>

{
  "encrypted" : true,
  "entry" : [ {
    "name" : "username",
    "value" : "MyUsername"
  }, {
    "name" : "password",
    "value" : "MyPassword"
  } ],
  "name" : "BasicAuthCredentials"
}
      

<KeyValueMapOperations name="getCredentials" mapIdentifier="BasicAuthCredentials">
  <Scope>apiproxy</Scope>
  <Get assignTo="credentials.username" index='1'>
    <Key>
      <Parameter>username</Parameter>
    </Key>
  </Get>
  <Get assignTo="credentials.password" index='1'>
    <Key>
      <Parameter>password</Parameter>
    </Key>
  </Get>
</KeyValueMapOperations>
      

<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>

पुष्टि करने की बुनियादी नीति के बारे में जानकारी

इस नीति में कार्रवाई करने के दो तरीके हैं:

• एन्कोड: Base64, वैरिएबल में सेव किए गए उपयोगकर्ता नाम और पासवर्ड को कोड में बदलता है
• डीकोड करना: Base64 कोड में बदली गई स्ट्रिंग से, उपयोगकर्ता नाम और पासवर्ड को डिकोड करता है

आम तौर पर, उपयोगकर्ता नाम और पासवर्ड को कुंजी/वैल्यू स्टोर में सेव किया जाता है और फिर इन्हें रनटाइम के दौरान, कुंजी/वैल्यू स्टोर से पढ़ा जाता है. कुंजी/वैल्यू स्टोर का इस्तेमाल करने के बारे में जानकारी के लिए, की वैल्यू मैप ऑपरेशन की नीति देखें.

एलिमेंट का रेफ़रंस

एलिमेंट रेफ़रंस, BasicAuthentication नीति के एलिमेंट और एट्रिब्यूट के बारे में जानकारी देता है.

<BasicAuthentication async="false" continueOnError="false" enabled="true" name="Basic-Authentication-1">
   <DisplayName>Basic Authentication 1</DisplayName>
   <Operation>Encode</Operation>
   <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
   <User ref="request.queryparam.username" />
   <Password ref="request.queryparam.password" />
   <AssignTo createNew="false">request.header.Authorization</AssignTo>
   <Source>request.header.Authorization</Source> 
</BasicAuthentication>

<BaseAuthentication> एट्रिब्यूट

<BasicAuthentication async="false" continueOnError="false" enabled="true" name="Basic-Authentication-1">

इस टेबल में उन एट्रिब्यूट के बारे में बताया गया है जो नीति के सभी पैरंट एलिमेंट के लिए एक जैसे होते हैं:

<DisplayName> एलिमेंट

मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) प्रॉक्सी एडिटर में, आम भाषा के अलग नाम से नीति को लेबल करने के लिए, name एट्रिब्यूट का इस्तेमाल करें.

<DisplayName>Policy Display Name</DisplayName>

<ऑपरेशन> एलिमेंट

इससे यह पता चलता है कि Base64 नीति, क्रेडेंशियल को कोड में बदलती है या डिकोड करती है.

<Operation>Encode</Operation>

<ignoreUnresolvedVariables> एलिमेंट

अगर किसी वैरिएबल को ठीक नहीं किया जा सकता, तो नीति को true पर सेट करने पर गड़बड़ी का मैसेज नहीं दिखेगा. सामान्य पुष्टि करने की नीति के लिए इस्तेमाल किए जाने पर, यह सेटिंग आम तौर पर false पर सेट होती है. आम तौर पर, अगर तय किए गए वैरिएबल में उपयोगकर्ता नाम या पासवर्ड नहीं मिलता है, तो आम तौर पर गड़बड़ी का मैसेज दिख सकता है.

<IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>

<User> एलिमेंट

• कोड में बदलने के लिए, <User> एलिमेंट का इस्तेमाल करके उपयोगकर्ता नाम वाले वैरिएबल के बारे में बताएं. उपयोगकर्ता नाम और पासवर्ड की वैल्यू को Base64 कोड में बदलने से पहले, कोलन लगाकर जोड़ा जाता है.
• डिकोड करने के लिए, वह वैरिएबल डालें जहां डिकोड किया गया उपयोगकर्ता नाम लिखा गया है.

<User ref="request.queryparam.username" /> 

एट्रिब्यूट

<Password> एलिमेंट

• कोड में बदलने के लिए, <Password> एलिमेंट का इस्तेमाल करके पासवर्ड वाले वैरिएबल की जानकारी दें.
• डिकोड करने के लिए, वह वैरिएबल डालें जहां डिकोड किया गया पासवर्ड लिखा गया है.

<Password ref="request.queryparam.password" />

एट्रिब्यूट

<assignTo> एलिमेंट

इस नीति से जनरेट की गई, कोड में बदली गई या डिकोड की गई वैल्यू के साथ, टारगेट वैरिएबल को सेट किया जाता है.

इस उदाहरण में बताया गया है कि नीति को मैसेज के Authorization हेडर को, जनरेट की गई वैल्यू पर सेट करना चाहिए:

<AssignTo createNew="false">request.header.Authorization</AssignTo>

एट्रिब्यूट

<सोर्स> एलिमेंट

डिकोड करने के लिए, ऐसा वैरिएबल जिसमें Base64 कोड में बदली गई स्ट्रिंग, Basic Base64EncodedString के तौर पर होती है. उदाहरण के लिए, ऑथराइज़ेशन हेडर से जुड़ा request.header.Authorization बताएं.

<Source>request.header.Authorization</Source>

फ़्लो वैरिएबल

इस नीति के काम न करने पर, इन फ़्लो वैरिएबल को सेट किया जाता है:

• BasicAuthentication.{policy_name}.failed (सही वैल्यू के साथ)

गड़बड़ी का रेफ़रंस

यह सेक्शन गड़बड़ी के कोड और दिखाए गए गड़बड़ी के मैसेज के बारे में बताता है. साथ ही, इस नीति के ट्रिगर होने पर Edge की मदद से सेट की गई गड़बड़ी के वैरिएबल के बारे में बताता है. यह जानकारी जानना ज़रूरी है कि क्या गड़बड़ियों को ठीक करने के लिए, गड़बड़ी से जुड़े नियम बनाए जा रहे हैं. ज़्यादा जानने के लिए, नीति से जुड़ी गड़बड़ियों के बारे में आपके लिए ज़रूरी जानकारी और गड़बड़ियों को ठीक करने के तरीके देखें.

रनटाइम से जुड़ी गड़बड़ियां

नीति के लागू होने पर ये गड़बड़ियां हो सकती हैं.

डिप्लॉयमेंट से जुड़ी गड़बड़ियां

ये गड़बड़ियां तब हो सकती हैं, जब इस नीति वाले किसी प्रॉक्सी को डिप्लॉय किया जाता है.

गड़बड़ी वाले वैरिएबल

रनटाइम में कोई गड़बड़ी होने पर ये वैरिएबल सेट किए जाते हैं. ज़्यादा जानकारी के लिए, नीति से जुड़ी गड़बड़ियों के बारे में आपके लिए ज़रूरी जानकारी देखें.

गड़बड़ी के जवाब का उदाहरण

{  
   "fault":{  
      "detail":{  
         "errorcode":"steps.basicauthentication.UnresolvedVariable"
      },
      "faultstring":"Unresolved variable : request.queryparam.password"
   }
}

गड़बड़ी के नियम का उदाहरण

<FaultRule name="Basic Authentication Faults">
    <Step>
        <Name>AM-UnresolvedVariable</Name>
        <Condition>(fault.name Matches "UnresolvedVariable") </Condition>
    </Step>
    <Step>
        <Name>AM-AuthFailedResponse</Name>
        <Condition>(fault.name = "InvalidBasicAuthenticationSource")</Condition>
    </Step>
    <Condition>(BasicAuthentication.BA-Authentication.failed = true) </Condition>
</FaultRule>

स्कीमा

मिलते-जुलते विषय

की वैल्यू मैप ऑपरेशन की नीति