SAML অ্যাসার্শন নীতি প্রয়োগ সংক্রান্ত সমস্যার সমাধান করা

আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন দেখুন। তথ্য

SourceNotConfigured

ত্রুটি বার্তা

Edge UI বা Edge ম্যানেজমেন্টের মাধ্যমে API প্রক্সি ডেপ্লয়মেন্ট এই সমস্যার মেসেজ সহ 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 নীতির নিম্নলিখিত এলিমেন্টগুলির মধ্যে এক বা একাধিক এলিমেন্ট সংজ্ঞায়িত করা না থাকলে বা খালি থাকলে API Proxy-এর ডিপ্লয়মেন্ট এই সমস্যার সাথে ব্যর্থ হয়: <Source>, <XPath>, <Namespaces>, <Namespace>.

যেমন, আপনি <XPath> এলিমেন্টটি মিস করলে অথবা <Source> এলিমেন্ট বা এর এন্টিটি ফাঁকা রাখলে, API প্রক্সি ডেপ্লয় করা যায় না।

ডায়াগনসিস

1. সমস্যার মেসেজ থেকে 'SAML অ্যাসার্শন যাচাই করুন' নীতি প্রয়োগ করা যায়নি বলে শনাক্ত করুন। যেমন, নিচের সমস্যার ক্ষেত্রে Validate SAML অ্যাসারশন নীতির নাম হল Validate-SAML-Assertion-1।

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

2. Validate SAML Assertion নীতি XML কাজ না করার কারণ পরীক্ষা করুন। নীতিতে নিম্নলিখিত এলিমেন্টগুলির মধ্যে একটি বা একাধিক এলিমেন্ট অনুপস্থিত বা খালি আছে কিনা তা চেক করুন: <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.
   

রেজোলিউশন

<Namespaces> এলিমেন্ট ও এর চাইল্ড এলিমেন্ট <Namespace>-এর সাথে <Source> এলিমেন্টের ভ্যালু সঠিকভাবে কনফিগার করা হয়েছে কিনা তা নিশ্চিত করুন। এছাড়াও, আপনাকে নিশ্চিত করতে হবে যে <XPath> এলিমেন্টটি সংজ্ঞায়িত করা হয়েছে এবং খালি নেই।

উপরে দেখানো SAML অ্যাসার্শন যাচাই করার নীতির উদাহরণটি ঠিক করতে, আপনি <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 UI বা Edge ম্যানেজমেন্টের মাধ্যমে API প্রক্সি ডেপ্লয়মেন্ট এই সমস্যার মেসেজ সহ 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.

সমস্যার স্ক্রিনশটের উদাহরণ

কারণ

ValidateSAMLAssertion নীতিতে <TrustStore> এলিমেন্ট খালি থাকলে বা উল্লেখ করা না থাকলে, API প্রক্সি ডেপ্লয় করা যায় না। সঠিক Trust Store থাকতে হবে।

ডায়াগনসিস

1. নির্দিষ্ট API প্রক্সিতে যেখানে সমস্যা হয়েছে সেখানে সব Validate SAML Assertion নীতি পরীক্ষা করুন। Validate SAML অ্যাসারশন নীতিতে <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> এলিমেন্ট নির্দিষ্ট করতে পারেন।

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

Truststore কীভাবে ব্যবহার করতে হয় সেই ব্যাপারে আরও তথ্যের জন্য Truststore ও Keystore দেখুন।

NullKeyStore

ত্রুটি বার্তা

Edge UI বা Edge ম্যানেজমেন্ট API-এর মাধ্যমে 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> খালি থাকলে বা উল্লেখ করা না থাকলে, API প্রক্সি ডেপ্লয় করা যায় না। সঠিক Keystore-এর নাম প্রয়োজন।

ডায়াগনসিস

1. নির্দিষ্ট API প্রক্সিতে যেখানে সমস্যা হয়েছে সেখানে Generate SAML Assertion সংক্রান্ত সব নীতি পরীক্ষা করুন। Generate SAML অ্যাসারশন নীতিতে চাইল্ড এলিমেন্ট <Name> খালি থাকলে বা <Keystore> এলিমেন্টে উল্লেখ করা না থাকলে, সেটিই ভুল হওয়ার কারণ।

   নিচে উল্লেখ করা SAML অ্যাসার্শন জেনারেট করার নীতিতে <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>
   

রেজোলিউশন

নিশ্চিত করুন যে চাইল্ড এলিমেন্ট <Name> সবসময় নির্দিষ্ট করা আছে এবং Generate SAML Assertion নীতির <Keystore> এলিমেন্টের মধ্যে খালি নেই।

উপরের উদাহরণটি সংশোধন করতে, আপনি <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 UI বা Edge ম্যানেজমেন্টের মাধ্যমে API প্রক্সি ডেপ্লয়মেন্ট এই সমস্যার মেসেজ সহ 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> খালি থাকলে বা উল্লেখ করা না থাকলে, API প্রক্সি ডেপ্লয় করা যায় না। সঠিক Keystore alias প্রয়োজন।

ডায়াগনসিস

1. নির্দিষ্ট API Proxy-তে যেখানে সমস্যা হয়েছে সেখানে Generate SAML Assertion নীতিগুলি পরীক্ষা করুন। Generate SAML অ্যাসারশন নীতিতে চাইল্ড এলিমেন্ট <Alias> খালি থাকলে বা <Keystore> এলিমেন্টে উল্লেখ করা না থাকলে, সেটিই ভুল হওয়ার কারণ।

   নিচে উল্লেখ করা SAML অ্যাসার্শন জেনারেট করার নীতিতে <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>
   

রেজোলিউশন

জেনারেট SAML অ্যাসার্শন নীতির <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 UI বা Edge ম্যানেজমেন্টের মাধ্যমে API প্রক্সি ডেপ্লয়মেন্ট এই সমস্যার মেসেজ সহ 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> এলিমেন্ট খালি থাকলে বা নির্দিষ্ট করা না থাকলে, API প্রক্সি ডেপ্লয় করা যায় না। সঠিক <Issuer> ভ্যালু প্রয়োজন।

ডায়াগনসিস

1. নির্দিষ্ট API প্রক্সি যেখানে সমস্যা হয়েছে সেখানে সব Generate SAML Assertion নীতি পরীক্ষা করুন। 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>
   

রেজোলিউশন

জেনারেট SAML অ্যাসার্শন নীতিতে <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 নীতি সংক্রান্ত রেফারেন্স নিবন্ধে কোড স্যাম্পেল থেকে উদাহরণ দেখুন।