forked from docs/doc-exports
Wei, Hongmin
f37f5291ef
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com> Co-authored-by: Wei, Hongmin <weihongmin1@huawei.com> Co-committed-by: Wei, Hongmin <weihongmin1@huawei.com>
109 lines
19 KiB
HTML
109 lines
19 KiB
HTML
<a name="iam_08_0003"></a><a name="iam_08_0003"></a>
|
|
|
|
<h1 class="topictitle1">Step 1: Create an Identity Provider</h1>
|
|
<div id="body1598524160363"><p id="iam_08_0003__en-us_topic_0175818704_p69242055193319">To establish a trust relationship between an enterprise identity provider and the cloud system, upload the metadata file of the cloud system to the identity provider, and then create an identity provider and upload the metadata file of the identity provider on the IAM console.</p>
|
|
<div class="section" id="iam_08_0003__en-us_topic_0175818704_section56174541186"><h4 class="sectiontitle">Prerequisites</h4><p id="iam_08_0003__en-us_topic_0175818704_p87291816195">As an enterprise administrator, you have registered an account in the cloud system and created user groups and granted them permissions in IAM.</p>
|
|
<div class="note" id="iam_08_0003__en-us_topic_0175818704_note55291749506"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="iam_08_0003__en-us_topic_0175818704_p1852994912016">The user groups created in IAM will be used to assign permissions to identity provider users mapped to the cloud system.</p>
|
|
</div></div>
|
|
</div>
|
|
<div class="section" id="iam_08_0003__section122531649172219"><a name="iam_08_0003__section122531649172219"></a><a name="section122531649172219"></a><h4 class="sectiontitle">Establishing a Trust Relationship</h4><p id="iam_08_0003__p6138519915420">To establish a trust relationship between the enterprise identity provider and the cloud system, exchange their metadata files.</p>
|
|
<ol id="iam_08_0003__ol1891826195920"><li id="iam_08_0003__li79110265593"><span>Download the metadata file of the cloud system. If both WebSSO and API calling need to be used, download the metadata files for the two functions.</span><p><ul id="iam_08_0003__ul0911126135910"><li id="iam_08_0003__li151101820314">WebSSO: Visit <a href="https://auth.otc.t-systems.com/authui/saml/metadata.xml" target="_blank" rel="noopener noreferrer">https://auth.otc.t-systems.com/authui/saml/metadata.xml</a>. Right-click, choose <strong id="iam_08_0003__b151991719114520">Save As</strong>, and set a file name, for example, <strong id="iam_08_0003__b519931918459">websso-metadata.xml</strong>.</li><li id="iam_08_0003__li19911726135911">API calling: Visit "https://<em id="iam_08_0003__i886388172919">Endpoint address of a region</em>/v3-ext/auth/OS-FEDERATION/SSO/metadata", right-click on the page, choose <strong id="iam_08_0003__b1286488162919">Save As</strong>, and set a file name, for example, <strong id="iam_08_0003__b20864389290">api-metadata-region.xml</strong>.<p id="iam_08_0003__p20911826195916">The cloud system provides different API gateways for users in different regions to call APIs. To allow users to access resources in multiple regions, download metadata files of all these regions.</p>
|
|
</li></ul>
|
|
</p></li><li id="iam_08_0003__li958574935920"><span>Upload the metadata file to the identity provider server. For details about how to upload the metadata file, see the documentation of your identity provider.</span></li><li id="iam_08_0003__li125612564591"><span>Obtain the metadata file of the enterprise identity provider. For details about how to obtain the metadata file, see the documentation of your identity provider.</span></li></ol>
|
|
</div>
|
|
<div class="section" id="iam_08_0003__section149171311484"><h4 class="sectiontitle">Creating an Identity Provider</h4><p id="iam_08_0003__en-us_topic_0175818704_p14271944725">Create an identity provider and configure the metadata file in IAM.</p>
|
|
<ol id="iam_08_0003__en-us_topic_0175818704_ol21644229"><li id="iam_08_0003__en-us_topic_0175818704_li7670737"><span>Log in to the IAM console, and choose <strong id="iam_08_0003__b251162073013">Identity Providers</strong> from the navigation pane. Then click <strong id="iam_08_0003__b9516122018304">Create Identity Provider</strong>.</span></li><li id="iam_08_0003__en-us_topic_0175818704_li202871146194"><span>On the displayed page, enter an identity provider name, select <strong id="iam_08_0003__b1916616470221">SAML</strong> for <strong id="iam_08_0003__b160919512226">Protocol</strong> and <strong id="iam_08_0003__b119611270239">Enabled</strong> for <strong id="iam_08_0003__b441862920230">Status</strong>. Then, click <strong id="iam_08_0003__b1874643082316">OK</strong>.</span><p><div class="note" id="iam_08_0003__note380511308321"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="iam_08_0003__p1980583019323">The identity provider name must be unique under your account.</p>
|
|
</div></div>
|
|
</p></li><li id="iam_08_0003__li1680343023216"><span>Click <strong id="iam_08_0003__b620513583019">OK</strong>.</span></li></ol>
|
|
</div>
|
|
<div class="section" id="iam_08_0003__section1245888153813"><h4 class="sectiontitle">Configuring the Metadata File</h4><p id="iam_08_0003__p12244184732818">Configure the metadata file of the enterprise IdP in the cloud system.</p>
|
|
<p id="iam_08_0003__p7265103664114">IAM provides <strong id="iam_08_0003__b10662182510277">preconfigured metadata</strong>. You can directly use or modify the preconfigured metadata. If you have obtained the metadata file of your enterprise IdP, <strong id="iam_08_0003__b512510533016">upload</strong> the file.</p>
|
|
<p id="iam_08_0003__p187418103815">For a metadata file larger than 500 KB, manually configure the metadata. If the metadata has changed, upload the latest metadata file or edit the existing metadata to ensure that the federated users can log in to the cloud system.</p>
|
|
<div class="note" id="iam_08_0003__note144179481770"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="iam_08_0003__p134181348175">For details about how to obtain the metadata file, see the documentation of the enterprise identity provider.</p>
|
|
</div></div>
|
|
<ul id="iam_08_0003__ul13549028387"><li id="iam_08_0003__li1527417420477"><strong id="iam_08_0003__b29912425388">Using preconfigured metadata</strong><ol id="iam_08_0003__ol17767114017483"><li id="iam_08_0003__li8561013134918">Click <strong id="iam_08_0003__b6169451392">Modify</strong> in the row containing the identity provider.</li><li id="iam_08_0003__li1656313144911">Click <strong id="iam_08_0003__b949145218342">Select</strong> next to <strong id="iam_08_0003__b6360125633419">Use preconfigured metadata</strong>. The preconfigured enterprise IdPs and their metadata are displayed.</li><li id="iam_08_0003__li169891225145011">Select an enterprise IdP, select the metadata, and click <strong id="iam_08_0003__b132816614362">OK</strong>.</li><li id="iam_08_0003__li181401445105110">Click <strong id="iam_08_0003__b48141721153616">Configured Metadata</strong> to view or modify the metadata.</li></ol>
|
|
</li><li id="iam_08_0003__li9578194417441"><strong id="iam_08_0003__b1784187203217">Uploading a metadata file</strong><ol id="iam_08_0003__ol1954315220382"><li id="iam_08_0003__li1888833818014">click <strong id="iam_08_0003__b1575471213216">Modify</strong> in the row containing the identity provider.</li><li id="iam_08_0003__li25415213812">Click <strong id="iam_08_0003__b351561517329">Select File</strong> and select the metadata file you have obtained.</li><li id="iam_08_0003__li454352183810">Click <strong id="iam_08_0003__b564221813212">Upload</strong>. The metadata extracted from the uploaded file is displayed. Click <strong id="iam_08_0003__b18724141912320">OK</strong>.<ul id="iam_08_0003__ul115414223816"><li id="iam_08_0003__li10541112123814">If the uploaded metadata file contains multiple identity providers, select the identity provider you want to use from the <strong id="iam_08_0003__b528132223219">Entity ID</strong> drop-down list.</li><li id="iam_08_0003__li195418219381">If a message is displayed indicating that no entity ID is specified or the signing certificate has expired, check the metadata file and upload it again, or configure the metadata manually.</li></ul>
|
|
</li><li id="iam_08_0003__li1954316214388">Click <strong id="iam_08_0003__b117028348329">OK</strong>.</li></ol>
|
|
</li><li id="iam_08_0003__li95491027381"><strong id="iam_08_0003__b1118423618324">Manually configuring metadata</strong><ol id="iam_08_0003__ol175491224389"><li id="iam_08_0003__li1254619217384">Click <strong id="iam_08_0003__b528173915325">Manually configure</strong>.</li><li id="iam_08_0003__li1654911233819">In the <strong id="iam_08_0003__b1835469174615">Configure Metadata</strong> dialog box, set the metadata parameters, such as the entity ID, signing certificate, and <strong id="iam_08_0003__b193607934612">SingleSignOnService</strong>.
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="iam_08_0003__table65491029383" frame="border" border="1" rules="all"><thead align="left"><tr id="iam_08_0003__row6547182103814"><th align="left" class="cellrowborder" valign="top" width="28.08%" id="mcps1.3.5.6.3.2.2.3.1.4.1.1"><p id="iam_08_0003__p14547162173813">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="9.69%" id="mcps1.3.5.6.3.2.2.3.1.4.1.2"><p id="iam_08_0003__p65471321386">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="62.23%" id="mcps1.3.5.6.3.2.2.3.1.4.1.3"><p id="iam_08_0003__p1654717212387">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="iam_08_0003__row45486218382"><td class="cellrowborder" valign="top" width="28.08%" headers="mcps1.3.5.6.3.2.2.3.1.4.1.1 "><p id="iam_08_0003__p15547728389">Entity ID</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9.69%" headers="mcps1.3.5.6.3.2.2.3.1.4.1.2 "><p id="iam_08_0003__p185479263813">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.23%" headers="mcps1.3.5.6.3.2.2.3.1.4.1.3 "><p id="iam_08_0003__p15471021389">The unique identifier of an identity provider. Enter the value of <strong id="iam_08_0003__b49941430114615">entityID</strong> displayed in the identity provider metadata file.</p>
|
|
<p id="iam_08_0003__p105479213387">If the metadata file contains multiple identity providers, choose the one you want to use.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="iam_08_0003__row05481124386"><td class="cellrowborder" valign="top" width="28.08%" headers="mcps1.3.5.6.3.2.2.3.1.4.1.1 "><p id="iam_08_0003__p15484211385">Protocol</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9.69%" headers="mcps1.3.5.6.3.2.2.3.1.4.1.2 "><p id="iam_08_0003__p15488212385">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.23%" headers="mcps1.3.5.6.3.2.2.3.1.4.1.3 "><p id="iam_08_0003__p19548723386">The SAML protocol is used for federated identity authentication between an enterprise identity provider and service provider.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="iam_08_0003__row554815273816"><td class="cellrowborder" valign="top" width="28.08%" headers="mcps1.3.5.6.3.2.2.3.1.4.1.1 "><p id="iam_08_0003__p45481521383">NameIdFormat</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9.69%" headers="mcps1.3.5.6.3.2.2.3.1.4.1.2 "><p id="iam_08_0003__p754816253816">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.23%" headers="mcps1.3.5.6.3.2.2.3.1.4.1.3 "><p id="iam_08_0003__p0548172123819">Enter the value of <strong id="iam_08_0003__b136091738143316">NameIdFormat</strong> displayed in the metadata file.</p>
|
|
<p id="iam_08_0003__p1854813212388">This parameter indicates the username and ID format used for communication between the identity provider and federated users.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="iam_08_0003__row954816283817"><td class="cellrowborder" valign="top" width="28.08%" headers="mcps1.3.5.6.3.2.2.3.1.4.1.1 "><p id="iam_08_0003__p35489283816">Signing Certificate</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9.69%" headers="mcps1.3.5.6.3.2.2.3.1.4.1.2 "><p id="iam_08_0003__p85488203810">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.23%" headers="mcps1.3.5.6.3.2.2.3.1.4.1.3 "><p id="iam_08_0003__p19548132203818">Enter the value of <strong id="iam_08_0003__b7948449103416"><X509Certificate></strong> displayed in the metadata file.</p>
|
|
<p id="iam_08_0003__p1054820293816">A signing certificate is a public key certificate used for signature verification. For security purposes, enter a public key containing no less than 2048 bits. The signing certificate is used during federated identity authentication to ensure that assertions are credible and complete.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="iam_08_0003__row125491029387"><td class="cellrowborder" valign="top" width="28.08%" headers="mcps1.3.5.6.3.2.2.3.1.4.1.1 "><p id="iam_08_0003__p15548727383">SingleSignOnService</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9.69%" headers="mcps1.3.5.6.3.2.2.3.1.4.1.2 "><p id="iam_08_0003__p10548162163813">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.23%" headers="mcps1.3.5.6.3.2.2.3.1.4.1.3 "><p id="iam_08_0003__p19548629389">Enter the value of <strong id="iam_08_0003__b3434121293517">SingleSignOnService</strong> displayed in the metadata file.</p>
|
|
<p id="iam_08_0003__p19548202123812">This parameter defines how SAML requests are sent during the SSO process. <strong id="iam_08_0003__b048218263352">SingleSignOnService</strong> must support HTTP Redirect or HTTP POST.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="iam_08_0003__row17549821380"><td class="cellrowborder" valign="top" width="28.08%" headers="mcps1.3.5.6.3.2.2.3.1.4.1.1 "><p id="iam_08_0003__p175491029386">SingleLogoutService</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9.69%" headers="mcps1.3.5.6.3.2.2.3.1.4.1.2 "><p id="iam_08_0003__p145493263820">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.23%" headers="mcps1.3.5.6.3.2.2.3.1.4.1.3 "><p id="iam_08_0003__p15491424385">Enter the value of <strong id="iam_08_0003__b631661124918">SingleLogoutService</strong> displayed in the metadata file.</p>
|
|
<p id="iam_08_0003__p5549624387">This parameter indicates the address to which federated users will be redirected after logging out their sessions. The <strong id="iam_08_0003__b164091743193514">SingleLogoutService</strong> parameter in the metadata file must support HTTP Redirect or HTTP POST.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="iam_08_0003__li1354902123815">Click <strong id="iam_08_0003__b16345195212357">OK</strong>.</li></ol>
|
|
</li></ul>
|
|
<ul id="iam_08_0003__ul1729510132320"><li id="iam_08_0003__li47290108238">Click <strong id="iam_08_0003__b1770031114912">OK</strong> to save the settings.</li></ul>
|
|
</div>
|
|
<div class="section" id="iam_08_0003__section15416142810318"><h4 class="sectiontitle">Logging In as a Federated User</h4><ol id="iam_08_0003__en-us_topic_0175818704_ol39932055154412"><li id="iam_08_0003__en-us_topic_0175818704_li3667194318261"><span>Click the login link displayed on the identity provider details page to check if the login page of the identity provider server is displayed.</span><p><ol type="a" id="iam_08_0003__en-us_topic_0175818704_ol1571111571714"><li id="iam_08_0003__en-us_topic_0175818704_li1671175717713">On the <strong id="iam_08_0003__b12407174917361">Identity Providers</strong> page, click <strong id="iam_08_0003__b20414194916367">View</strong> in the <strong id="iam_08_0003__b154161549103614">Operation</strong> column of the identity provider. Copy the login link displayed on the identity provider details page and visit the link using a browser.</li><li id="iam_08_0003__en-us_topic_0175818704_li13241914283">If the login page is not displayed, check the metadata file and configurations of the identity provider server.</li></ol>
|
|
</p></li><li id="iam_08_0003__en-us_topic_0175818704_li10993125510445"><span>Enter the username and password of a user that was created in the enterprise management system.</span><p><ul id="iam_08_0003__en-us_topic_0175818704_ul5993205514416"><li id="iam_08_0003__en-us_topic_0175818704_li12993145515449">If the login is successful, add the login link to the enterprise's official website.</li><li id="iam_08_0003__en-us_topic_0175818704_li599315564412">If the login fails, check the username and password.</li></ul>
|
|
<div class="note" id="iam_08_0003__en-us_topic_0175818704_note1176022717104"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="iam_08_0003__en-us_topic_0175818704_p0761527151014">Federated users only have read permissions for the cloud system by default. To assign permissions to federated users, configure identity conversion rules for the identity provider. For more information, see <a href="iam_08_0004.html">Step 2: Configure Identity Conversion Rules</a>.</p>
|
|
</div></div>
|
|
</p></li></ol>
|
|
</div>
|
|
<div class="section" id="iam_08_0003__section0966344193213"><h4 class="sectiontitle">Related Operations</h4><ul id="iam_08_0003__en-us_topic_0175818704_ul4296945016821"><li id="iam_08_0003__en-us_topic_0175818704_li3998488416821">Viewing identity provider information: In the identity provider list, click <strong id="iam_08_0003__b33838395385">View</strong> in the row containing the identity provider, and view its basic information, metadata, and identity conversion rules.<div class="note" id="iam_08_0003__en-us_topic_0175818704_note1768310816844"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="iam_08_0003__en-us_topic_0175818704_p2493024416844">To modify the configurations of an identity provider, click <strong id="iam_08_0003__b1831111503387">Modify</strong> at the bottom of the details page.</p>
|
|
</div></div>
|
|
</li><li id="iam_08_0003__en-us_topic_0175818704_li1227968616821">Modifying an identity provider: In the identity provider list, click <strong id="iam_08_0003__b16962101520818">Modify</strong> in the row containing the identity provider, and then change its status and modify the description, metadata, and identity conversion rules.</li><li id="iam_08_0003__en-us_topic_0175818704_li5904713316821">Deleting an identity provider: In the identity provider list, click <strong id="iam_08_0003__b1544693093912">Delete</strong> in the row containing the identity provider, and click <strong id="iam_08_0003__b1451173017391">Yes</strong>.</li></ul>
|
|
</div>
|
|
<div class="section" id="iam_08_0003__section19341115343217"><h4 class="sectiontitle">Follow-Up Procedure</h4><ul id="iam_08_0003__en-us_topic_0175818704_ul11792191715210"><li id="iam_08_0003__en-us_topic_0175818704_li18792111735212">In the <strong id="iam_08_0003__b11324145115412">Identity Conversion Rules</strong> area, create an identity conversion rule. For details, see <a href="iam_08_0004.html">Step 2: Configure Identity Conversion Rules</a>.</li><li id="iam_08_0003__en-us_topic_0175818704_li4910182155212">Configure the enterprise management system to allow users to access the cloud system through SSO. For details, see <a href="iam_08_0005.html">Step 3: Configure Login Link in the Enterprise Management System</a>.</li></ul>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="iam_08_0002.html">SAML-based Federated Identity Authentication</a></div>
|
|
</div>
|
|
</div>
|
|
|