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

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

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" التي تعذّر تنفيذها من رسالة الخطأ. على سبيل المثال، في الخطأ التالي، يكون اسم سياسة Validate SAML Assertion هو 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> فارغًا أو غير محدّد في سياسة ValidateSAMLAssertion، سيتعذّر نشر خادم API الوكيل. يجب توفُّر "متجر موثوق به" صالح.

التشخيص

  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>

راجِع ملفات Truststore وKeystore لمزيد من المعلومات حول كيفية استخدام Truststore.

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، سيتعذّر نشر خادم API الوكيل. يجب إدخال اسم صالح لملف تخزين المفاتيح.

التشخيص

  1. افحص جميع سياسات &quot;إنشاء تأكيد SAML&quot; في خادم API الوكيل المحدّد الذي حدث فيه الخطأ. إذا كانت هناك أي سياسة Generate SAML Assertion لا يحتوي فيها العنصر الفرعي <Name> على أي قيمة أو لم يتم تحديده في العنصر <Keystore>، سيكون ذلك هو سبب الخطأ.

    تحتوي سياسة Generate SAML Assertion التالية على عنصر فرعي فارغ <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> الخاص بسياسة Generate SAML Assertion، سيتعذّر نشر خادم API الوكيل. يجب إدخال اسم مستعار صالح لملف تخزين المفاتيح.

التشخيص

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

    تحتوي سياسة Generate SAML Assertion التالية على عنصر فرعي فارغ <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> فارغًا أو لم يتم تحديده في سياسة Generate SAML Assertion، سيتعذّر نشر خادم API الوكيل. يجب إدخال قيمة <Issuer> صالحة.

التشخيص

  1. افحص جميع سياسات &quot;إنشاء تأكيد SAML&quot; في خادم وكيل واجهة برمجة التطبيقات المحدّد الذي حدث فيه الخطأ. إذا كانت هناك أي سياسة Generate SAML Assertion لا يتضمّن العنصر <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.