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

أنت تعرض مستندات Apigee Edge.
انتقل إلى مستندات Apigee X. معلومات

SourceNotConfigured

رسالة الخطأ

نشر الخادم الوكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو إدارة Edge تعذّر واجهة برمجة التطبيقات مع ظهور رسالة الخطأ التالية:

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.

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

السبب

يخفق نشر الخادم الوكيل لواجهة برمجة التطبيقات مع ظهور هذا الخطأ في حالة واحدة أو أكثر من العناصر التالية من سياسة تأكيد 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 تعذّر واجهة برمجة التطبيقات مع ظهور رسالة الخطأ التالية:

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> فارغًا أو غير محدّد في السمة التحقق من صحة SAMLAssertion، ثم نشر واجهة برمجة التطبيقات فشل الخادم الوكيل. يجب توفّر متجر موثوق به صالح.

التشخيص

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

الدقة

تأكد من أن العنصر <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>

يُرجى الاطّلاع على المستودعات الموثوق بها وملفات تخزين المفاتيح للحصول على مزيد من المعلومات حول كيفية استخدام Truststore.

NullKeyStore

رسالة الخطأ

نشر الخادم الوكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو Edge تعطُّل واجهة برمجة التطبيقات management مع رسالة الخطأ التالية:

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 تعذّر واجهة برمجة التطبيقات مع ظهور رسالة الخطأ التالية:

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 تعذّر واجهة برمجة التطبيقات مع ظهور رسالة الخطأ التالية:

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.