{"id":195,"date":"2023-11-20T16:13:06","date_gmt":"2023-11-20T15:13:06","guid":{"rendered":"https:\/\/helpdesk.ovio365.com\/?p=195"},"modified":"2024-04-29T16:22:50","modified_gmt":"2024-04-29T14:22:50","slug":"kapitel-3-saml-installation","status":"publish","type":"post","link":"https:\/\/helpdesk.ovio365.com\/?p=195","title":{"rendered":"Kapitel 6 SAML Installation"},"content":{"rendered":"\n[et_pb_section fb_built=&#8220;1&#8243; _builder_version=&#8220;4.23.1&#8243; _module_preset=&#8220;default&#8220; global_colors_info=&#8220;{}&#8220;][et_pb_row _builder_version=&#8220;4.25.0&#8243; _module_preset=&#8220;default&#8220;][et_pb_column _builder_version=&#8220;4.25.0&#8243; _module_preset=&#8220;default&#8220; type=&#8220;4_4&#8243;][et_pb_text _builder_version=&#8220;4.25.0&#8243; _module_preset=&#8220;default&#8220; header_5_line_height=&#8220;1.5em&#8220; hover_enabled=&#8220;0&#8243; global_colors_info=&#8220;{}&#8220; sticky_enabled=&#8220;0&#8243;]<p>In diesem Abschnitt werden wir die <strong>SAML Integration<\/strong> von OVIO besprechen. Mit diesem Bereichen k\u00f6nnen wir unsere Applikation in Ihren jetzigen <strong>Identity Provider<\/strong> ohne gro\u00dfen Aufwand integrieren. Dies f\u00fchrt zu einem <strong>automatischen<\/strong> Import, Benutzerpflege und einer Zuweisung der Berechtigungen in Unternehmensbasierten Gruppen \/ Abteilungen.<\/p>[\/et_pb_text][\/et_pb_column][\/et_pb_row][et_pb_row _builder_version=&#8220;4.25.0&#8243; _module_preset=&#8220;default&#8220;][et_pb_column _builder_version=&#8220;4.25.0&#8243; _module_preset=&#8220;default&#8220; type=&#8220;4_4&#8243;][et_pb_text _builder_version=&#8220;4.23.1&#8243; _module_preset=&#8220;default&#8220; global_colors_info=&#8220;{}&#8220;]<h1><span class=\"ez-toc-section\" id=\"1_SAML_Anbieter\"><\/span>1. SAML Anbieter<span class=\"ez-toc-section-end\"><\/span><\/h1>[\/et_pb_text][et_pb_text _builder_version=&#8220;4.23.1&#8243; _module_preset=&#8220;default&#8220; header_5_line_height=&#8220;1.5em&#8220; global_colors_info=&#8220;{}&#8220;]<p>Amazon AWS Identity<\/p>\n<p>Google Identity<\/p>\n<p>Microsoft Entra<\/p>\n<p>OCTA<\/p>\n<p>Jeder weitere Anbieter der SAML 2.0 unterst\u00fctzt.<\/p>[\/et_pb_text][\/et_pb_column][\/et_pb_row][et_pb_row _builder_version=&#8220;4.25.0&#8243; _module_preset=&#8220;default&#8220;][et_pb_column _builder_version=&#8220;4.25.0&#8243; _module_preset=&#8220;default&#8220; type=&#8220;4_4&#8243;][et_pb_text _builder_version=&#8220;4.23.1&#8243; _module_preset=&#8220;default&#8220; global_colors_info=&#8220;{}&#8220;]<h1><span class=\"ez-toc-section\" id=\"2_SAML_Voraussetzungen\"><\/span>2. SAML Voraussetzungen<span class=\"ez-toc-section-end\"><\/span><\/h1>[\/et_pb_text][et_pb_text _builder_version=&#8220;4.23.1&#8243; _module_preset=&#8220;default&#8220; global_colors_info=&#8220;{}&#8220;]<p>In diesem Beispiel orientieren wir uns an einer Microsoft Entra Integration.<\/p>[\/et_pb_text][\/et_pb_column][\/et_pb_row][et_pb_row _builder_version=&#8220;4.25.0&#8243; _module_preset=&#8220;default&#8220;][et_pb_column _builder_version=&#8220;4.25.0&#8243; _module_preset=&#8220;default&#8220; type=&#8220;4_4&#8243;][et_pb_text _builder_version=&#8220;4.23.1&#8243; _module_preset=&#8220;default&#8220; global_colors_info=&#8220;{}&#8220;]<h2><span class=\"ez-toc-section\" id=\"21_SAML_Configuration\"><\/span>2.1. SAML Configuration<span class=\"ez-toc-section-end\"><\/span><\/h2>[\/et_pb_text][et_pb_text _builder_version=&#8220;4.23.1&#8243; _module_preset=&#8220;default&#8220; global_colors_info=&#8220;{}&#8220;]<table border=\"1\" style=\"border-collapse: collapse; width: 100%; height: 96px;\">\n<tbody>\n<tr style=\"height: 24px;\">\n<td style=\"width: 50%; height: 24px;\">\n<p><strong>Attribut<\/strong><\/p>\n<\/td>\n<td style=\"width: 50%; height: 24px;\">\n<p><strong>Wert<\/strong><\/p>\n<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 50%; height: 24px;\">\n<p>Identifier (Entity ID)<\/p>\n<\/td>\n<td style=\"width: 50%; height: 24px;\">\n<p>https:\/\/serverurl.domin.de\/something<\/p>\n<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 50%; height: 24px;\">\n<p>Reply URL (Assertion Consumer Service URL)<\/p>\n<\/td>\n<td style=\"width: 50%; height: 24px;\">\n<p>https:\/\/serverurl.domin.de\/something<\/p>\n<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 50%; height: 24px;\">\n<p>Logout URL\u00a0<\/p>\n<\/td>\n<td style=\"width: 50%; height: 24px;\">\n<p>https:\/\/serverurl.domin.de\/something\/something<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>[\/et_pb_text][\/et_pb_column][\/et_pb_row][et_pb_row _builder_version=&#8220;4.25.0&#8243; _module_preset=&#8220;default&#8220;][et_pb_column _builder_version=&#8220;4.25.0&#8243; _module_preset=&#8220;default&#8220; type=&#8220;4_4&#8243;][et_pb_text _builder_version=&#8220;4.23.1&#8243; _module_preset=&#8220;default&#8220; global_colors_info=&#8220;{}&#8220;]<h2><span class=\"ez-toc-section\" id=\"22_SAML_Attribute\"><\/span>2.2. SAML Attribute<span class=\"ez-toc-section-end\"><\/span><\/h2>[\/et_pb_text][et_pb_text _builder_version=&#8220;4.23.1&#8243; _module_preset=&#8220;default&#8220; global_colors_info=&#8220;{}&#8220;]<table border=\"1\" style=\"border-collapse: collapse; width: 100%;\">\n<tbody>\n<tr>\n<td style=\"width: 50%;\">\n<p><strong>OVIO Parameter<\/strong><\/p>\n<\/td>\n<td style=\"width: 50%;\">\n<p><strong>Beispiel Microsoft Entra<\/strong><\/p>\n<\/td>\n<\/tr>\n<tr>\n<td style=\"width: 50%;\">\n<p><span>user_assignedroles<\/span><\/p>\n<\/td>\n<td style=\"width: 50%;\">\n<p><span>user.assignedroles<\/span><\/p>\n<\/td>\n<\/tr>\n<tr>\n<td style=\"width: 50%;\">\n<p><span>user_givenname<\/span><\/p>\n<\/td>\n<td style=\"width: 50%;\">\n<p><span>user.givenname<\/span><\/p>\n<\/td>\n<\/tr>\n<tr>\n<td style=\"width: 50%;\">\n<p><span>user_isEnabled<\/span><\/p>\n<\/td>\n<td style=\"width: 50%;\">\n<p><span>user.accountenabled<\/span><\/p>\n<\/td>\n<\/tr>\n<tr>\n<td style=\"width: 50%;\">\n<p><span>user_language<\/span><\/p>\n<\/td>\n<td style=\"width: 50%;\">\n<p><span>user.preferredlanguage<\/span><\/p>\n<\/td>\n<\/tr>\n<tr>\n<td style=\"width: 50%;\">\n<p><span>user_mail<\/span><\/p>\n<\/td>\n<td style=\"width: 50%;\">\n<p><span>user.mail<\/span><\/p>\n<\/td>\n<\/tr>\n<tr>\n<td style=\"width: 50%;\">\n<p><span>user_phone<\/span><\/p>\n<\/td>\n<td style=\"width: 50%;\">\n<p><span>user.mobilephone<\/span><\/p>\n<\/td>\n<\/tr>\n<tr>\n<td style=\"width: 50%;\">\n<p><span>user_surname<\/span><\/p>\n<\/td>\n<td style=\"width: 50%;\">\n<p><span>user.surname<\/span><\/p>\n<\/td>\n<\/tr>\n<tr>\n<td style=\"width: 50%;\">\n<p><span>user_groups<\/span><\/p>\n<\/td>\n<td style=\"width: 50%;\">\n<p><span>user.groups<\/span><\/p>\n<\/td>\n<\/tr>\n<tr>\n<td style=\"width: 50%;\">\n<p><span>Unique User Identifier<\/span><\/p>\n<\/td>\n<td style=\"width: 50%;\">\n<p><span>user.userprincipalname<\/span><\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>[\/et_pb_text][\/et_pb_column][\/et_pb_row][et_pb_row _builder_version=&#8220;4.25.0&#8243; _module_preset=&#8220;default&#8220;][et_pb_column _builder_version=&#8220;4.25.0&#8243; _module_preset=&#8220;default&#8220; type=&#8220;4_4&#8243;][et_pb_text _builder_version=&#8220;4.23.1&#8243; _module_preset=&#8220;default&#8220; global_colors_info=&#8220;{}&#8220;]<h2><span class=\"ez-toc-section\" id=\"23_SAML_Zertifikate\"><\/span>2.3. SAML Zertifikate<span class=\"ez-toc-section-end\"><\/span><\/h2>[\/et_pb_text][et_pb_text _builder_version=&#8220;4.23.1&#8243; _module_preset=&#8220;default&#8220; header_5_line_height=&#8220;1.5em&#8220; global_colors_info=&#8220;{}&#8220;]<p>Die Support Abteilung ben\u00f6tigt bei dem Einrichtungstermin von Ihnen eine Federation Metadata XML Datei mit integriertem Zertifikat ein Beispiel wie sowas aussieht sehen Sie hier:<\/p>[\/et_pb_text][et_pb_text _builder_version=&#8220;4.23.1&#8243; _module_preset=&#8220;default&#8220; header_5_line_height=&#8220;1.5em&#8220; global_colors_info=&#8220;{}&#8220;]<div>\n<p><span>&lt;?<\/span><span>xml<\/span><span> version<\/span><span>=<\/span><span>&#8222;1.0&#8220;<\/span><span> encoding<\/span><span>=<\/span><span>&#8222;utf-8&#8220;<\/span><span>?&gt;&lt;<\/span><span>EntityDescriptor<\/span><span> <\/span><span>ID<\/span><span>=<\/span><span>&#8222;_171ef52486&#8220;<\/span><span> <\/span><span>entityID<\/span><span>=<\/span><span>&#8222;https:\/\/sts.windows.net\/&#8220;<\/span><span> <\/span><span>xmlns<\/span><span>=<\/span><span>&#8222;urn:oasis:names:tc:SAML:2.0:metadata&#8220;<\/span><span>&gt;<\/span><\/p>\n<p><span>&lt;<\/span><span>Signature<\/span><span> <\/span><span>xmlns<\/span><span>=<\/span><span>&#8222;http:\/\/www.w3.org\/2000\/09\/xmldsig#&#8220;<\/span><span>&gt;<\/span><\/p>\n<p><span>&lt;<\/span><span>SignedInfo<\/span><span>&gt;&lt;<\/span><span>CanonicalizationMethod<\/span><span> <\/span><span>Algorithm<\/span><span>=<\/span><span>&#8222;http:\/\/www.w3.org\/2001\/10\/xml-exc-c14n#&#8220;<\/span><span> <\/span><span>\/&gt;<\/span><\/p>\n<p><span>&lt;<\/span><span>SignatureMethod<\/span><span> <\/span><span>Algorithm<\/span><span>=<\/span><span>&#8222;http:\/\/www.w3.org\/2001\/04\/xmldsig-more#rsa-sha256&#8220;<\/span><span> <\/span><span>\/&gt;<\/span><\/p>\n<p><span>&lt;<\/span><span>Reference<\/span><span> <\/span><span>URI<\/span><span>=<\/span><span>&#8222;#_171ef597-486&#8220;<\/span><span>&gt;&lt;<\/span><span>Transforms<\/span><span>&gt;<\/span><\/p>\n<p><span>&lt;<\/span><span>Transform<\/span><span> <\/span><span>Algorithm<\/span><span>=<\/span><span>&#8222;http:\/\/www.w3.org\/2000\/09\/xmldsig#enveloped-signature&#8220;<\/span><span> <\/span><span>\/&gt;<\/span><\/p>\n<p><span>&lt;<\/span><span>Transform<\/span><span> <\/span><span>Algorithm<\/span><span>=<\/span><span>&#8222;http:\/\/www.w3.org\/2001\/10\/xml-exc-c14n#&#8220;<\/span><span> <\/span><span>\/&gt;&lt;\/<\/span><span>Transforms<\/span><span>&gt;<\/span><\/p>\n<p><span>&lt;<\/span><span>DigestMethod<\/span><span> <\/span><span>Algorithm<\/span><span>=<\/span><span>&#8222;http:\/\/www.w3.org\/2001\/04\/xmlenc#sha256&#8220;<\/span><span> <\/span><span>\/&gt;<\/span><\/p>\n<p><span>&lt;<\/span><span>DigestValue<\/span><span>&gt;&lt;\/<\/span><span>DigestValue<\/span><span>&gt;<\/span><\/p>\n<p><span>&lt;\/<\/span><span>Reference<\/span><span>&gt;&lt;\/<\/span><span>SignedInfo<\/span><span>&gt;&lt;<\/span><span>SignatureValue<\/span><span>&gt;&lt;\/<\/span><span>SignatureValue<\/span><span>&gt;<\/span><\/p>\n<p><span>&lt;<\/span><span>KeyInfo<\/span><span>&gt;&lt;<\/span><span>X509Data<\/span><span>&gt;&lt;<\/span><span>X509Certificate<\/span><span>&gt;&lt;\/<\/span><span>X509Certificate<\/span><span>&gt;<\/span><\/p>\n<p><span>&lt;\/<\/span><span>X509Data<\/span><span>&gt;&lt;\/<\/span><span>KeyInfo<\/span><span>&gt;&lt;\/<\/span><span>Signature<\/span><span>&gt;<\/span><\/p>\n<p><span>&lt;<\/span><span>RoleDescriptor<\/span><span> <\/span><span>xsi:type<\/span><span>=<\/span><span>&#8222;fed:SecurityTokenServiceType&#8220;<\/span><span> <\/span><span>protocolSupportEnumeration<\/span><span>=<\/span><span>&#8222;http:\/\/docs.oasis-open.org\/wsfed\/federation\/200706&#8220;<\/span><span> <\/span><span>xmlns:xsi<\/span><span>=<\/span><span>&#8222;http:\/\/www.w3.org\/2001\/XMLSchema-instance&#8220;<\/span><span> <\/span><span>xmlns:fed<\/span><span>=<\/span><span>&#8222;http:\/\/docs.oasis-open.org\/wsfed\/federation\/200706&#8220;<\/span><span>&gt;<\/span><\/p>\n<p><span>&lt;<\/span><span>KeyDescriptor<\/span><span> <\/span><span>use<\/span><span>=<\/span><span>&#8222;signing&#8220;<\/span><span>&gt;&lt;<\/span><span>KeyInfo<\/span><span> <\/span><span>xmlns<\/span><span>=<\/span><span>&#8222;http:\/\/www.w3.org\/2000\/09\/xmldsig#&#8220;<\/span><span>&gt;<\/span><\/p>\n<p><span>&lt;<\/span><span>X509Data<\/span><span>&gt;&lt;<\/span><span>X509Certificate<\/span><span>&gt;&lt;\/<\/span><span>X509Certificate<\/span><span>&gt;&lt;\/<\/span><span>X509Data<\/span><span>&gt;<\/span><\/p>\n<p><span>&lt;\/<\/span><span>KeyInfo<\/span><span>&gt;&lt;\/<\/span><span>KeyDescriptor<\/span><span>&gt;&lt;<\/span><span>fed:ClaimTypesOffered<\/span><span>&gt;<\/span><\/p>\n<\/div>[\/et_pb_text][\/et_pb_column][\/et_pb_row][et_pb_row _builder_version=&#8220;4.25.0&#8243; _module_preset=&#8220;default&#8220;][et_pb_column _builder_version=&#8220;4.25.0&#8243; _module_preset=&#8220;default&#8220; type=&#8220;4_4&#8243;][et_pb_text _builder_version=&#8220;4.23.1&#8243; _module_preset=&#8220;default&#8220; global_colors_info=&#8220;{}&#8220;]<h2><span class=\"ez-toc-section\" id=\"24_SAML_Gruppen_Import\"><\/span>2.4. SAML Gruppen Import<span class=\"ez-toc-section-end\"><\/span><\/h2>[\/et_pb_text][et_pb_text _builder_version=&#8220;4.23.1&#8243; _module_preset=&#8220;default&#8220; header_5_line_height=&#8220;1.5em&#8220; global_colors_info=&#8220;{}&#8220;]<p>Um die Firmen internen Gruppen nutzen zu k\u00f6nnen, sollten Sie einmalig die AD Gruppen die Sie importieren m\u00f6chten in eine .CSV Datei exportieren und in der Administration in OVIO Importieren. Hier werden dann einmalig die gew\u00fcnschten Berechtigungen pro Abteilung gepflegt. Die Zuweisungen der Nutzer passiert dann automatisch bei der Anmeldung durch das SAML SSO werden die Gruppenzugeh\u00f6rigkeiten aufgel\u00f6st und gespeichert. So bliebt Ihre OVIO Cloud immer sauber und frei von importierten &#8222;M\u00fcll&#8220; wie z.B. inaktive Nutzer, Exchange Postf\u00e4cher private Gruppen usw.<\/p>[\/et_pb_text][et_pb_text _builder_version=&#8220;4.23.1&#8243; _module_preset=&#8220;default&#8220; global_colors_info=&#8220;{}&#8220;]<p>Ein Beispiel der Felder die OVIO bei einem Gruppen Import erwartet. Das Trennzeichen sollte ein ; sein.<\/p>[\/et_pb_text][et_pb_text _builder_version=&#8220;4.23.1&#8243; _module_preset=&#8220;default&#8220; global_colors_info=&#8220;{}&#8220;]<table border=\"1\" style=\"border-collapse: collapse; width: 100%;\">\n<tbody>\n<tr>\n<td width=\"80\" style=\"width: 14.5695%;\">\n<p>id<\/p>\n<\/td>\n<td width=\"88\" style=\"width: 21.1921%;\">\n<p>displayName<\/p>\n<\/td>\n<td width=\"73\" style=\"width: 19.2053%;\">\n<p>groupType<\/p>\n<\/td>\n<td width=\"117\" style=\"width: 28.0353%;\">\n<p>membershipType<\/p>\n<\/td>\n<td width=\"48\" style=\"width: 16.9978%;\">\n<p>source<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td width=\"34\" style=\"width: 14.5695%;\">\n<p>mail<\/p>\n<\/td>\n<td width=\"106\" style=\"width: 21.1921%;\">\n<p>securityEnabled<\/p>\n<\/td>\n<td width=\"84\" style=\"width: 19.2053%;\">\n<p>mailEnabled<\/p>\n<\/td>\n<td width=\"128\" style=\"width: 28.0353%;\">\n<p>isAssignableToRole<\/p>\n<\/td>\n<td width=\"160\" style=\"width: 16.9978%;\">\n<p>onPremisesSyncEnabled<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>[\/et_pb_text][\/et_pb_column][\/et_pb_row][et_pb_row _builder_version=&#8220;4.23.1&#8243; _module_preset=&#8220;default&#8220; global_colors_info=&#8220;{}&#8220;][et_pb_column type=&#8220;4_4&#8243; _builder_version=&#8220;4.23.1&#8243; _module_preset=&#8220;default&#8220; global_colors_info=&#8220;{}&#8220;][et_pb_post_nav in_same_term=&#8220;on&#8220; _builder_version=&#8220;4.23.1&#8243; _module_preset=&#8220;default&#8220; global_colors_info=&#8220;{}&#8220;][\/et_pb_post_nav][\/et_pb_column][\/et_pb_row][\/et_pb_section]\n","protected":false},"excerpt":{"rendered":"<p>In diesem Abschnitt werden wir die SAML Integration von OVIO besprechen. Mit diesem Bereichen k\u00f6nnen wir unsere Applikation in Ihren jetzigen Identity Provider ohne gro\u00dfen Aufwand integrieren. Dies f\u00fchrt zu einem automatischen Import, Benutzerpflege und einer Zuweisung der Berechtigungen in Unternehmensbasierten Gruppen \/ Abteilungen.1. SAML AnbieterAmazon AWS Identity Google Identity Microsoft Entra OCTA Jeder weitere [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_et_pb_use_builder":"on","_et_pb_old_content":"","_et_gb_content_width":"","footnotes":""},"categories":[7],"tags":[],"class_list":["post-195","post","type-post","status-publish","format-standard","hentry","category-ovio-administrator-guide"],"_links":{"self":[{"href":"https:\/\/helpdesk.ovio365.com\/index.php?rest_route=\/wp\/v2\/posts\/195","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/helpdesk.ovio365.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/helpdesk.ovio365.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/helpdesk.ovio365.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/helpdesk.ovio365.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=195"}],"version-history":[{"count":0,"href":"https:\/\/helpdesk.ovio365.com\/index.php?rest_route=\/wp\/v2\/posts\/195\/revisions"}],"wp:attachment":[{"href":"https:\/\/helpdesk.ovio365.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=195"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/helpdesk.ovio365.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=195"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/helpdesk.ovio365.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=195"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}