سياسات SAMLتأكيد

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

المزايا

• مصادقة البريد الوارد وتفويضه: التحقُّق من صحة تأكيد SAML السياسة
  يتيح نوع سياسة SAML للخوادم الوكيلة لواجهة برمجة التطبيقات التحقق من صحة تأكيدات SAML المرفقة بـ طلبات SOAP الواردة. تتحقّق سياسة SAML من الرسائل الواردة التي تحتوي على تأكيد SAML الموقَّع رقميًا، ورفضه إذا كانت غير صالحة، وإعداد المتغيرات التي السماح بالسياسات الإضافية أو خدمات الخلفية نفسها بالتحقق من المعلومات بشكل أكبر في التأكيد.
• إنشاء الرموز المميّزة الصادرة: إنشاء سياسة تأكيد SAML
  يتيح نوع سياسة SAML للخوادم الوكيلة لواجهة برمجة التطبيقات إرفاق تأكيدات SAML بطلبات XML الصادرة. بعد ذلك، تتوفر هذه التأكيدات لتفعيل خدمات الخلفية لتطبيق المزيد من الأمان. لمعالجة المصادقة والترخيص.

نماذج

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

<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>
    <AssertionXPath>/soap:Envelope/soap:Header/wsse:Security/saml:Assertion</AssertionXPath>
    <SignedElementXPath>/soap:Envelope/soap:Header/wsse:Security/saml:Assertion</SignedElementXPath>
  </Source>
  <TrustStore>TrustStoreName</TrustStore>
  <RemoveAssertion>false</RemoveAssertion>
</ValidateSAMLAssertion>

مرجع العنصر

إنشاء تأكيد SAML

التحقق من صحة تأكيد SAML

ملاحظات الاستخدام

تحدد مواصفات لغة ترميز تأكيد الأمان (SAML) التنسيقات والبروتوكولات التي تمكين التطبيقات من تبادل المعلومات بتنسيق XML للمصادقة التفويض.

"تأكيد الأمان" هو رمز مميز موثوق به يصف سمة التطبيق أو مستخدم التطبيق أو مشارك آخر في معاملة. تتم إدارة تأكيدات الأمان واستخدامها من قِبل مستخدمَين أنواع الكيانات:

• موفِّرو الهوية: إنشاء تأكيدات الأمان نيابةً عن المشاركين
• مقدِّمو الخدمات: التحقق من صحة تأكيدات الأمان من خلال علاقات موثوقة مع الهوية مقدّمو خدمة

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

يتوافق نوع سياسة SAML مع تأكيدات SAML التي تطابق الإصدار 2.0 من SAML Core المواصفات والإصدار 1.0 من مواصفات الملف الشخصي للرمز المميز لـ WS-Security SAML.

إنشاء تأكيد SAML

معالجة السياسة:

1. إذا لم تكن الرسالة بتنسيق XML، ولم يتم ضبط نوع البيانات المراد تجاهله على true، ارتكاب خطأ.
2. إذا كان "نموذج" ثم معالجة النموذج كما هو موضح في سياسة AssignMessage. في حال عدم توفّر أي متغيّرات وعدم ضبط UnknownUnresolvedVariables، أبلِغ خطأ.
3. إذا كان "نموذج" ما لم يتم تعيينها، فقم بإنشاء تأكيد يتضمن قيم مَعلمات الموضوع وجهة الإصدار أو مراجعهما
4. وقِّع على التأكيد باستخدام المفتاح المحدّد.
5. أضف التأكيد إلى الرسالة في XPath المحدد.

التحقق من صحة تأكيد SAML

معالجة السياسة:

1. تفحص السياسة الرسالة الواردة للتأكّد من أنّ نوع وسائط الطلب هو XML، وذلك من خلال التحقّق ممّا إذا كان نوع المحتوى يتطابق مع التنسيقات text/(.*+)?xml أو application/(.*+)?xml إذا لم يكن نوع الوسائط هو XML لم يتم ضبط السياسة <IgnoreContentType>، وسيؤدي ذلك إلى حدوث خطأ.
2. ستحلِّل السياسة ملف XML. إذا تعذّر التحليل، سيؤدي ذلك إلى حدوث خطأ.
3. ستستخرج السياسة العنصر المُوقَّع والتأكيد، باستخدام مسارات XPath المعنية المحددة (<SignedElementXPath> و<AssertionXPath>). وإذا لم يؤدي أي من هذه المسارات إلى أحد العناصر، فإن السياسة ستنشئ خطأ.
4. ستتحقّق السياسة من أنّ التأكيد هو نفسه العنصر الموقَّع. هي عنصر ثانوي للعنصر المميز. وإذا لم يكن هذا صحيحًا، ستُظهر السياسة خطأً.
5. إذا كانت إحدى القيمتَين <NotBefore> أو <NotOnOrAfter> هذه العناصر في التأكيد، ستتحقق السياسة من الطابع الزمني الحالي مقابل هذه القيم، كما هو موضح في القسم 2.5.1 الأساسي من SAML.
6. ستطبِّق السياسة أي قواعد إضافية لمعالجة "الشروط". كما هو موضح في القسم 2.5.1.1 من SAML Core.
7. ستتحقق السياسة من صحة التوقيع الرقمي بتنسيق XML، باستخدام قيم <TrustStore> و<ValidateSigner> كما هو موضّح أعلاه. وفي حال تعذُّر عملية التحقّق، سيُحدث خطأ بسبب السياسة.

بعد اكتمال السياسة بدون الإبلاغ عن خطأ، يمكن لمطوّر الخادم الوكيل التأكّد من ما يلي:

• التوقيع الرقمي على التأكيد صالح وتم توقيعه من قِبل مرجع تصديق موثوق به.
• التأكيد صالح للفترة الزمنية الحالية
• سيتم استخراج موضوع التأكيد وجهة إصداره وضبطه في متغيّرات التدفق. من المهم مسؤولية السياسات الأخرى عن استخدام هذه القيم لإجراء مصادقة إضافية، مثل التحقق من أن اسم الموضوع صالح أو تمريره إلى نظام مستهدف للتحقق من صحته.

يمكن استخدام السياسات الأخرى، مثل TransportVariables، لتحليل XML الأولي للتأكيد. لإجراء عملية تحقق أكثر تعقيدًا.

متغيّرات التدفق

هناك الكثير من المعلومات التي يمكن تحديدها في تأكيد SAML. معيار SAML هو سمة XML يمكن تحليلها باستخدام سياسة OutputVariables آليات من أجل تنفيذ عمليات تحقق أكثر تعقيدًا.

مرجع الخطأ

يصف هذا القسم رموز الأخطاء ورسائل الخطأ التي يتم عرضها. ومتغيرات الخطأ التي تحددها Edge عندما تؤدي هذه السياسة إلى ظهور خطأ. من المهم معرفة هذه المعلومات إذا كنت تضع قواعد خطأ التعامل مع الأخطاء. للحصول على مزيد من المعلومات، يمكنك الاطّلاع على ما تحتاج إلى معرفته حول أخطاء السياسة والتعامل مع المعالجة والأخطاء.

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

متغيّرات الأخطاء

يتم ضبط هذه المتغيّرات عند حدوث خطأ في بيئة التشغيل. يمكنك الاطّلاع على مقالة ما تحتاج إلى معرفته للحصول على مزيد من المعلومات. حول أخطاء السياسة.

مثال على استجابة الخطأ

{
  "fault": {
    "faultstring": "GenerateSAMLAssertion[GenSAMLAssert]: Invalid media type",
    "detail": {
      "errorcode": "steps.saml.generate.InvalidMediaTpe"
    }
  }
}

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

<FaultRules>
    <FaultRule name="invalid_saml_rule">
        <Step>
            <Name>invalid-saml</Name>
        </Step>
        <Condition>(GenerateSAMLAssertion.failed = "true")</Condition>
    </FaultRule>
</FaultRules>

مواضيع ذات صلة

استخراج المتغيّرات: استخراج المتغيّرات السياسة