एसएएमएल दावा नीति के डिप्लॉयमेंट से जुड़ी गड़बड़ी की समस्या हल करना

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

SourceNotConfigured

गड़बड़ी का मैसेज

Edge यूज़र इंटरफ़ेस (यूआई) या Edge Management API के ज़रिए एपीआई प्रॉक्सी को डिप्लॉय करने पर, यह गड़बड़ी का मैसेज दिखता है:

Error Deploying Revision revision_number to environment
ValidateSAMLAssertion[policy_name]: Source is not correctly configured.

गड़बड़ी के मैसेज का उदाहरण

Error Deploying Revision 2 to test
ValidateSAMLAssertion[Validate-SAML-Assertion-1]: Source is not correctly configured.

गड़बड़ी के उदाहरण का स्क्रीनशॉट

वजह

अगर Validate SAML Assertion नीति के एक या उससे ज़्यादा एलिमेंट तय नहीं किए गए हैं या खाली हैं, तो एपीआई प्रॉक्सी को डिप्लॉय करने में यह गड़बड़ी होती है: <Source>, <XPath>, <Namespaces>, <Namespace>.

उदाहरण के लिए, अगर आपने <XPath> एलिमेंट को शामिल नहीं किया है या <Source> एलिमेंट या उसकी इकाइयों को खाली छोड़ दिया है, तो एपीआई प्रॉक्सी को डिप्लॉय नहीं किया जा सकेगा.

संक्रमण की जांच

1. गड़बड़ी के मैसेज से, 'एसएएमएल दावे की पुष्टि करें' नीति का वह नाम पता करें जिसके लिए पुष्टि नहीं हो सकी. उदाहरण के लिए, यहां दी गई गड़बड़ी में Validate SAML Assertion नीति का नाम Validate-SAML-Assertion-1 है.

   ValidateSAMLAssertion[Validate-SAML-Assertion-1]: Source is not correctly configured.
   

2. SAML Assertion की पुष्टि करने से जुड़ी नीति के उस एक्सएमएल की जांच करें जिसमें गड़बड़ी हुई है. देखें कि नीति के इनमें से एक या उससे ज़्यादा एलिमेंट मौजूद नहीं हैं या खाली हैं: <Source>, <XPath>, <Namespaces>, <Namespace>. अगर ऐसा है, तो हो सकता है कि गड़बड़ी की वजह यही हो.

   उदाहरण के लिए, यहां दी गई नीति में <Source> एलिमेंट के नीचे, <Namespaces> एलिमेंट खाली है:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <ValidateSAMLAssertion name="SAML" ignoreContentType="false">
     <Source name="request">
       <Namespaces></Namespaces>
      </Source>
      <Description/>
    <TrustStore>ref://TrustStoreName</Truststore>
    <RemoveAssertion>false</RemoveAssertion>
   </ValidateSAMLAssertion>
   

3. ऊपर दिए गए उदाहरण में, <Namespaces> एलिमेंट खाली है. इसलिए, आपको यह गड़बड़ी दिखेगी:

   ValidateSAMLAssertion[Validate-SAML-Assertion-1]: Source is not correctly configured.
   

रिज़ॉल्यूशन

पक्का करें कि <Source> एलिमेंट की वैल्यू, <Namespaces> एलिमेंट और उसके चाइल्ड एलिमेंट <Namespace> के साथ सही तरीके से कॉन्फ़िगर की गई हों. आपको यह भी पक्का करना होगा कि <XPath> एलिमेंट तय किया गया हो और उसमें वैल्यू मौजूद हो.

ऊपर दिखाई गई, एसएएमएल दावे की पुष्टि करने से जुड़ी नीति के उदाहरण को ठीक करने के लिए, <Namespace> एलिमेंट के साथ-साथ <XPath> भी जोड़ा जा सकता है:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ValidateSAMLAssertion name="SAML" ignoreContentType="false">
  <Source name="request">
    <Namespaces>
      <Namespace prefix='soap'>http://schemas.xmlsoap.org/soap/envelope/</Namespace>
      <Namespace prefix='wsse'>http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd</Namespace>
      <Namespace prefix='saml'>urn:oasis:names:tc:SAML:2.0:assertion</Namespace>
    </Namespaces>
    <XPath>/soap:Envelope/soap:Header/wsse:Security/saml:Assertion</XPath>
  </Source>
   <Description/>
<TrustStore>ref://TrustStoreName</Truststore>
<RemoveAssertion>false</RemoveAssertion>
</ValidateSAMLAssertion>

TrustStoreNotConfigured

गड़बड़ी का मैसेज

Edge यूज़र इंटरफ़ेस (यूआई) या Edge Management API के ज़रिए एपीआई प्रॉक्सी को डिप्लॉय करने पर, यह गड़बड़ी का मैसेज दिखता है:

Error Deploying Revision revision_number to environment
ValidateSAMLAssertion[[Ljava.lang.Object;@object]: Trust store is not correctly configured.

गड़बड़ी के मैसेज का उदाहरण

Error Deploying Revision 2 to test
ValidateSAMLAssertion[[Ljava.lang.Object;@39537262]: Trust store is not correctly configured.

गड़बड़ी के उदाहरण का स्क्रीनशॉट

वजह

अगर <TrustStore> एलिमेंट खाली है या ValidateSAMLAssertion नीति में नहीं दिया गया है, तो एपीआई प्रॉक्सी को डिप्लॉय नहीं किया जा सकेगा. भरोसेमंद स्टोर होना ज़रूरी है.

संक्रमण की जांच

1. उस एपीआई प्रॉक्सी में Validate SAML Assertion की सभी नीतियों की जांच करें जहां गड़बड़ी हुई है. अगर Validate SAML Assertion नीति में कोई ऐसा <TrustStore> एलिमेंट है जिसमें कोई वैल्यू नहीं है या जिसे तय नहीं किया गया है, तो यह गड़बड़ी इसी वजह से हुई है.

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <ValidateSAMLAssertion name="SAML" ignoreContentType="false">
    <Source name="request">
       <Namespaces>
         <Namespace prefix='soap'>http://schemas.xmlsoap.org/soap/envelope/</Namespace>
         <Namespace prefix='wsse'>http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd</Namespace>
         <Namespace prefix='saml'>urn:oasis:names:tc:SAML:2.0:assertion</Namespace>
       </Namespaces>
       <XPath>/soap:Envelope/soap:Header/wsse:Security/saml:Assertion</XPath>
     </Source>
       <Description/>
       <TrustStore/>
     <RemoveAssertion>false</RemoveAssertion>
   </ValidateSAMLAssertion>
   

रिज़ॉल्यूशन

पक्का करें कि Validate SAML Assertion नीति में, <TrustStore> एलिमेंट हमेशा तय किया गया हो और इसमें कोई वैल्यू मौजूद हो. <TrustStore> नाम, किसी मान्य TrustStore के नाम से मेल खाना चाहिए. यह TrustStore, उन सभी एनवायरमेंट में मौजूद होना चाहिए जहां आपको प्रॉक्सी डिप्लॉय करनी है.

ऊपर दिए गए उदाहरण को ठीक करने के लिए, <TrustStore> एलिमेंट के लिए मान्य वैल्यू दी जा सकती है.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ValidateSAMLAssertion name="SAML" ignoreContentType="false">
  <Source name="request">
    <Namespaces>
      <Namespace prefix='soap'>http://schemas.xmlsoap.org/soap/envelope/</Namespace>
      <Namespace prefix='wsse'>http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd</Namespace>
      <Namespace prefix='saml'>urn:oasis:names:tc:SAML:2.0:assertion</Namespace>
    </Namespaces>
    <XPath>/soap:Envelope/soap:Header/wsse:Security/saml:Assertion</XPath>
  </Source>
  <TrustStore>TrustStoreName</TrustStore>
  <RemoveAssertion>false</RemoveAssertion>
</ValidateSAMLAssertion>

ट्रस्टस्टोर इस्तेमाल करने के तरीके के बारे में ज़्यादा जानने के लिए, ट्रस्टस्टोर और कीस्टोर देखें.

NullKeyStore

गड़बड़ी का मैसेज

Edge यूज़र इंटरफ़ेस (यूआई) या Edge Management API के ज़रिए एपीआई प्रॉक्सी को डिप्लॉय करने पर, यह गड़बड़ी का मैसेज दिखता है:

Error Deploying Revision revision_number to environment
Assertion KeyStore name cannot be null.

गड़बड़ी के मैसेज का उदाहरण

Error Deploying Revision 4 to test
Assertion KeyStore name cannot be null.

गड़बड़ी के उदाहरण का स्क्रीनशॉट

वजह

अगर GenerateSAMLAssertion नीति के <Keystore> एलिमेंट में, चाइल्ड एलिमेंट <Name> खाली है या उसके बारे में नहीं बताया गया है, तो एपीआई प्रॉक्सी को डिप्लॉय नहीं किया जा सकेगा. Keystore का मान्य नाम डालना ज़रूरी है.

संक्रमण की जांच

1. उस एपीआई प्रॉक्सी में, SAML असर्शन जनरेट करने से जुड़ी सभी नीतियों की जांच करें जहां गड़बड़ी हुई है. अगर Generate SAML Assertion नीति में कोई ऐसा चाइल्ड एलिमेंट <Name> है जिसमें <Keystore> एलिमेंट में कोई वैल्यू नहीं दी गई है या उसे तय नहीं किया गया है, तो गड़बड़ी की वजह यही है.

   नीचे दी गई Generate SAML Assertion नीति में, <Keystore> एलिमेंट में मौजूद चाइल्ड एलिमेंट <Name> खाली है:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <GenerateSAMLAssertion name="SAML" ignoreContentType="false">`
     <CanonicalizationAlgorithm />
     <Issuer ref="reference">Issuer name</Issuer>
     <KeyStore>
       <Name></Name>
       <Alias ref="reference">alias</Alias>
     </KeyStore>
     <OutputVariable>
       <FlowVariable>assertion.content</FlowVariable>
       <Message name="request">
         <Namespaces>
           <Namespace prefix="test">http://www.example.com/test</Namespace>
         </Namespaces>
         <XPath>/envelope/header</XPath>
       </Message>
     </OutputVariable>
     <SignatureAlgorithm />
     <Subject ref="reference">Subject name</Subject>
     <Template ignoreUnresolvedVariables="false">
       <!-- A lot of XML goes here, in CDATA, with {} around
            each variable -->
     </Template>
   </GenerateSAMLAssertion>
   

रिज़ॉल्यूशन

पक्का करें कि Generate SAML Assertion नीति के <Keystore> एलिमेंट में, चाइल्ड एलिमेंट <Name> हमेशा तय किया गया हो और वह खाली न हो.

ऊपर दिए गए उदाहरण को ठीक करने के लिए, <Name> एलिमेंट को सही तरीके से तय करें. साथ ही, यह भी पक्का करें कि <Alias> एलिमेंट के लिए मान्य वैल्यू दी गई हो.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<GenerateSAMLAssertion name="SAML" ignoreContentType="false">
  <CanonicalizationAlgorithm />
  <Issuer ref="reference">Issuer name</Issuer>
  <KeyStore>
    <Name ref="reference">keystorename</Name>
    <Alias ref="reference">alias</Alias>
  </KeyStore>
  <OutputVariable>
    <FlowVariable>assertion.content</FlowVariable>
    <Message name="request">
      <Namespaces>
        <Namespace prefix="test">http://www.example.com/test</Namespace>
      </Namespaces>
      <XPath>/envelope/header</XPath>
    </Message>
  </OutputVariable>
  <SignatureAlgorithm />
  <Subject ref="reference">Subject name</Subject>
  <Template ignoreUnresolvedVariables="false">
    <!-- A lot of XML goes here, in CDATA, with {} around
         each variable -->
  </Template>
</GenerateSAMLAssertion>

SAMLAssertion नीति के रेफ़रंस लेख में दिए गए कोड सैंपल के उदाहरण देखें.

NullKeyStoreAlias

गड़बड़ी का मैसेज

Edge यूज़र इंटरफ़ेस (यूआई) या Edge Management API के ज़रिए एपीआई प्रॉक्सी को डिप्लॉय करने पर, यह गड़बड़ी का मैसेज दिखता है:

Error Deploying Revision revision_number to environment
Assertion KeyStore alias cannot be null.

गड़बड़ी के मैसेज का उदाहरण

Error Deploying Revision 4 to test
Assertion KeyStore alias cannot be null.

गड़बड़ी के उदाहरण का स्क्रीनशॉट

वजह

अगर Generate SAML Assertion नीति के <Keystore> एलिमेंट में, चाइल्ड एलिमेंट <Alias> की वैल्यू खाली है या उसे नहीं दिया गया है, तो एपीआई प्रॉक्सी को डिप्लॉय नहीं किया जा सकेगा. मान्य कीस्टोर एलियास डालना ज़रूरी है.

संक्रमण की जांच

1. उस एपीआई प्रॉक्सी में, SAML असर्शन जनरेट करने से जुड़ी सभी नीतियों की जांच करें जहां गड़बड़ी हुई है. अगर Generate SAML Assertion नीति में कोई ऐसा चाइल्ड एलिमेंट <Alias> है जिसमें <Keystore> एलिमेंट में कोई वैल्यू नहीं दी गई है या उसे तय नहीं किया गया है, तो गड़बड़ी की वजह यही है.

   नीचे दी गई Generate SAML Assertion नीति में, <Keystore> एलिमेंट में मौजूद चाइल्ड एलिमेंट <Alias> खाली है:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <GenerateSAMLAssertion name="SAML" ignoreContentType="false">`
     <CanonicalizationAlgorithm />
     <Issuer ref="reference">Issuer name</Issuer>
     <KeyStore>
       <Name ref="reference">keystorename</Name>
       <Alias></Alias>
     </KeyStore>
     <OutputVariable>
       <FlowVariable>assertion.content</FlowVariable>
       <Message name="request">
         <Namespaces>
           <Namespace prefix="test">http://www.example.com/test</Namespace>
         </Namespaces>
         <XPath>/envelope/header</XPath>
       </Message>
     </OutputVariable>
     <SignatureAlgorithm />
     <Subject ref="reference">Subject name</Subject>
     <Template ignoreUnresolvedVariables="false">
       <!-- A lot of XML goes here, in CDATA, with {} around
            each variable -->
     </Template>
   </GenerateSAMLAssertion>
   

रिज़ॉल्यूशन

पक्का करें कि Generate SAML Assertion नीति के <Keystore> एलिमेंट में, चाइल्ड एलिमेंट <Name> हमेशा तय किया गया हो और वह खाली न हो.

ऊपर दिए गए उदाहरण को ठीक करने के लिए, <Alias> एलिमेंट को सही तरीके से तय करें. साथ ही, यह पक्का करें कि <Name> एलिमेंट के लिए मान्य वैल्यू दी गई हो.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<GenerateSAMLAssertion name="SAML" ignoreContentType="false">
  <CanonicalizationAlgorithm />
  <Issuer ref="reference">Issuer name</Issuer>
  <KeyStore>
    <Name ref="reference">keystorename</Name>
    <Alias ref="reference">alias</Alias>
  </KeyStore>
  <OutputVariable>
    <FlowVariable>assertion.content</FlowVariable>
    <Message name="request">
      <Namespaces>
        <Namespace prefix="test">http://www.example.com/test</Namespace>
      </Namespaces>
      <XPath>/envelope/header</XPath>
    </Message>
  </OutputVariable>
  <SignatureAlgorithm />
  <Subject ref="reference">Subject name</Subject>
  <Template ignoreUnresolvedVariables="false">
    <!-- A lot of XML goes here, in CDATA, with {} around
         each variable -->
  </Template>
</GenerateSAMLAssertion>

SAMLAssertion नीति के रेफ़रंस लेख में दिए गए कोड सैंपल के उदाहरण देखें.

NullIssuer

गड़बड़ी का मैसेज

Edge यूज़र इंटरफ़ेस (यूआई) या Edge Management API के ज़रिए एपीआई प्रॉक्सी को डिप्लॉय करने पर, यह गड़बड़ी का मैसेज दिखता है:

Error Deploying Revision revision_number to environment
Assertion Issuer cannot be null.

गड़बड़ी के मैसेज का उदाहरण

Error Deploying Revision 4 to test
Assertion Issuer cannot be null.

गड़बड़ी के उदाहरण का स्क्रीनशॉट

वजह

अगर Generate SAML Assertion नीति में <Issuer> एलिमेंट खाली है या इसे तय नहीं किया गया है, तो एपीआई प्रॉक्सी को डिप्लॉय नहीं किया जा सकेगा. <Issuer> की मान्य वैल्यू डालना ज़रूरी है.

संक्रमण की जांच

1. उस एपीआई प्रॉक्सी में, SAML असर्शन जनरेट करने से जुड़ी सभी नीतियां देखें जहां गड़बड़ी हुई है. अगर Generate SAML Assertion नीति में कोई ऐसा <Issuer> एलिमेंट है जिसकी वैल्यू खाली है या जिसे तय नहीं किया गया है, तो यह गड़बड़ी की वजह है.

   Generate SAML Assertion नीति में, <Issuer> एलिमेंट की वैल्यू नहीं दी गई है:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <GenerateSAMLAssertion name="SAML" ignoreContentType="false">`
     <CanonicalizationAlgorithm />
     <Issuer></Issuer>
     <KeyStore>
       <Name ref="reference">keystorename</Name>
       <Alias ref="reference">alias</Alias>
     </KeyStore>
     <OutputVariable>
       <FlowVariable>assertion.content</FlowVariable>
       <Message name="request">
         <Namespaces>
           <Namespace prefix="test">http://www.example.com/test</Namespace>
         </Namespaces>
         <XPath>/envelope/header</XPath>
       </Message>
     </OutputVariable>
     <SignatureAlgorithm />
     <Subject ref="reference">Subject name</Subject>
     <Template ignoreUnresolvedVariables="false">
       <!-- A lot of XML goes here, in CDATA, with {} around
            each variable -->
     </Template>
   </GenerateSAMLAssertion>
   

रिज़ॉल्यूशन

पक्का करें कि Generate SAML Assertion नीति में, <Issuer> एलिमेंट हमेशा तय किया गया हो और खाली न हो.

ऊपर दिए गए उदाहरण को ठीक करने के लिए, <Issuer> एलिमेंट को सही तरीके से डालें:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<GenerateSAMLAssertion name="SAML" ignoreContentType="false">
  <CanonicalizationAlgorithm />
  <Issuer ref="reference">Issuer name</Issuer>
  <KeyStore>
    <Name ref="reference">keystorename</Name>
    <Alias ref="reference">alias</Alias>
  </KeyStore>
  <OutputVariable>
    <FlowVariable>assertion.content</FlowVariable>
    <Message name="request">
      <Namespaces>
        <Namespace prefix="test">http://www.example.com/test</Namespace>
      </Namespaces>
      <XPath>/envelope/header</XPath>
    </Message>
  </OutputVariable>
  <SignatureAlgorithm />
  <Subject ref="reference">Subject name</Subject>
  <Template ignoreUnresolvedVariables="false">
    <!-- A lot of XML goes here, in CDATA, with {} around
         each variable -->
  </Template>
</GenerateSAMLAssertion>

SAMLAssertion नीति के रेफ़रंस लेख में दिए गए कोड सैंपल के उदाहरण देखें.