تحديد المشاكل وحلّها في ما يتعلّق بنشر سياسة تأكيد SAML

أنت تطّلع على مستندات 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.

مثال على لقطة شاشة الخطأ

السبب

يتعذّر نشر "خادم API الوكيل" مع ظهور هذا الخطأ إذا لم يتم تحديد أحد العناصر التالية أو أكثر من سياسة "التحقّق من صحة تعريف SAML" أو كانت فارغة: <Source> أو <XPath> أو <Namespaces> أو <Namespace>.

على سبيل المثال، إذا فاتك العنصر <XPath> أو تركت العنصر <Source> أو كياناته فارغة، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات.

التشخيص

1. حدِّد اسم سياسة التحقّق من صحة تأكيد SAML التي تعذّر إكمالها من رسالة الخطأ. على سبيل المثال، في الخطأ التالي، يكون اسم سياسة تأكيد SAML هو Validate-SAML-Assertion-1.

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

2. راجِع ملف XML الخاص بسياسة التحقّق من صحة ملف تعريف SAML الذي تعذّر إثبات صلاحيته. تحقّق مما إذا كان هناك عنصر واحد أو أكثر من عناصر السياسة التالية غير متوفّر أو فارغ: <Source> أو <XPath> أو <Namespaces> أو <Namespace>. إذا كان الأمر كذلك، قد يكون هذا هو سبب الخطأ.

   على سبيل المثال، تتضمّن السياسة التالية عنصر <Namespaces> فارغًا ضمن العنصر <Source>:

   <?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> محدّد وليس فارغًا.

لتصحيح مثال سياسة التحقّق من صحة تأكيد 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 أو 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. راجِع جميع سياسات التحقّق من صحة تعريف SAML في وكيل واجهة برمجة التطبيقات المعنيّ الذي حدث فيه العُطل. إذا كانت هناك أي سياسة 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>
   

الدقة

تأكَّد من تحديد العنصر <TrustStore> دائمًا وعدم خلوّه من المحتوى ضمن سياسة التحقّق من صحة تأكيد SAML. يجب أن يتطابق <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 مع ظهور رسالة الخطأ التالية:

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.

مثال على لقطة شاشة الخطأ

السبب

إذا كان العنصر الفرعي <Name> فارغًا أو لم يتم تحديده في عنصر <Keystore> لسياسة GenerateSAMLAssertion، سيتعذّر نشر الوكيل لواجهة برمجة التطبيقات. يجب إدخال اسم مفتاح تشفير صالح.

التشخيص

1. راجِع جميع سياسات إنشاء تعريفات SAML في وكيل واجهة برمجة التطبيقات المعنيّ الذي حدث فيه العُطل. إذا كانت هناك أي سياسة لإنشاء ملف تعريف هوية SAML يكون فيها العنصر الفرعي <Name> خاليًا أو غير محدّد في العنصر <Keystore>، هذا هو سبب الخطأ.

   تحتوي سياسة "إنشاء تعريف SAML" التالية على عنصر <Name> فارغ في عنصر <Keystore>:

   <?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> محدّد دائمًا وغير فارغ ضمن العنصر <Keystore> في سياسة "إنشاء تأكيد SAML" .

لتصحيح المثال أعلاه، يمكنك تحديد عنصر <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.

مثال على لقطة شاشة الخطأ

السبب

إذا كان العنصر الفرعي <Alias> فارغًا أو لم يتم تحديده في عنصر <Keystore> ضمن سياسة "إنشاء تعريف SAML"، سيتعذّر نشر الوكيل لواجهة برمجة التطبيقات. يجب توفُّر عنوان بديل صالح لمستودع المفاتيح.

التشخيص

1. افحص جميع سياسات إنشاء تأكيد SAML في خادم وكيل واجهة برمجة التطبيقات المحدّد حيث حدث الفشل. إذا كانت هناك أي سياسة لإنشاء ملف تعريف هوية SAML يكون فيها العنصر الفرعي <Alias> خاليًا أو غير محدّد في العنصر <Keystore>، هذا هو سبب الخطأ.

   تحتوي سياسة "إنشاء تعريف SAML" التالية على عنصر <Alias> فارغ في عنصر <Keystore>:

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

الدقة

تأكَّد من أنّ العنصر الفرعي <Name> محدّد دائمًا وغير فارغ ضمن العنصر <Keystore> في سياسة "إنشاء تعريف SAML".

لتصحيح المثال أعلاه، يمكنك تحديد عنصر <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.

مثال على لقطة شاشة الخطأ

السبب

إذا كان عنصر <Issuer> فارغًا أو لم يتم تحديده في سياسة إنشاء ملف تعريف هوية SAML ، سيتعذّر نشر الوكيل لواجهة برمجة التطبيقات. يجب إدخال قيمة <Issuer> صالحة.

التشخيص

1. راجِع جميع سياسات إنشاء تعريفات SAML في واجهة برمجة التطبيقات الوكيل المحدّدة التي حدث فيها الخطأ. إذا كانت هناك أي سياسة لإنشاء ملف تعريف هوية SAML يفتقر عنصر <Issuer> فيها إلى قيمة أو لم يتم تحديد قيمة له، هذا هو سبب الخطأ.

   تحتوي سياسة إنشاء تأكيد SAML التالية على عنصر <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>
   

الدقة

تأكَّد من أنّ عنصر <Issuer> محدّد دائمًا وغير فارغ في سياسة "إنشاء تعريف SAML".

لتصحيح المثال أعلاه، حدِّد العنصر <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.