forked from docs/doc-exports
Wei, Hongmin
25e8bdf969
Reviewed-by: Belejkanic, Lukas <lukas.belejkanic@t-systems.com> Co-authored-by: Wei, Hongmin <weihongmin1@huawei.com> Co-committed-by: Wei, Hongmin <weihongmin1@huawei.com>
78 lines
16 KiB
HTML
78 lines
16 KiB
HTML
<a name="iam_08_0008"></a><a name="iam_08_0008"></a>
|
|
|
|
<h1 class="topictitle1">Step 2: Configure Identity Conversion Rules</h1>
|
|
<div id="body1598524160363"><p id="iam_08_0008__en-us_topic_0272668140_p41845487216">Federated users are named <strong id="iam_08_0008__en-us_topic_0272668140_b43751964517">FederationUser</strong> by default in the cloud platform. These users can only log in to the cloud platform and they do not have any other permissions. You can configure identity conversion rules on the IAM console to achieve the following:</p>
|
|
<ul id="iam_08_0008__en-us_topic_0272668140_ul418464817219"><li id="iam_08_0008__en-us_topic_0272668140_li11184114802114">Display enterprise users with different names in the cloud platform.</li><li id="iam_08_0008__en-us_topic_0272668140_li98061347112212">Assign permissions to enterprise users to use the cloud platform resources by mapping these users to IAM user groups. Ensure that you have created the required user groups. For details, see <a href="en-us_topic_0046611269.html">Creating a User Group and Assigning Permissions</a>.</li></ul>
|
|
<div class="note" id="iam_08_0008__en-us_topic_0272668140_note1948818531918"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="iam_08_0008__en-us_topic_0272668140_ul13451511218"><li id="iam_08_0008__en-us_topic_0272668140_li1945151328">Modifications to identity conversion rules will take effect only after the federated users log in again.</li><li id="iam_08_0008__en-us_topic_0272668140_li194511711521">To modify the permissions of a user, modify the permissions of the user group to which the user belongs. Then restart the enterprise IdP for the modifications to take effect.</li></ul>
|
|
</div></div>
|
|
<div class="section" id="iam_08_0008__en-us_topic_0272668140_section52965331"><h4 class="sectiontitle">Prerequisites</h4><p id="iam_08_0008__en-us_topic_0272668140_p788583051816">An IdP entity has been created, and the login link of the IdP is accessible. (For details about how to create and verify an IdP entity, see <a href="iam_08_0009.html#iam_08_0009">Step 1: Create an IdP Entity</a>.)</p>
|
|
</div>
|
|
<div class="section" id="iam_08_0008__en-us_topic_0272668140_en-us_topic_0175818756_section49143529"><h4 class="sectiontitle">Procedure</h4><p id="iam_08_0008__en-us_topic_0272668140_en-us_topic_0175818756_p176995795319">If you configure identity conversion rules by clicking <strong id="iam_08_0008__en-us_topic_0272668140_b772817219113">Create Rule</strong>, IAM converts the rule parameters to the JSON format. Alternatively, you can click <strong id="iam_08_0008__en-us_topic_0272668140_b1873492111114">Edit Rule</strong> to configure rules in JSON format. For details, see <a href="en-us_topic_0079620340.html">Syntax of Identity Conversion Rules</a>.</p>
|
|
<ul id="iam_08_0008__en-us_topic_0272668140_ul13542143916305"><li id="iam_08_0008__en-us_topic_0272668140_li0542239143020"><strong id="iam_08_0008__en-us_topic_0272668140_b19495192191220">Creating Rules</strong><ol id="iam_08_0008__en-us_topic_0272668140_ol14917184617414"><li id="iam_08_0008__en-us_topic_0272668140_li10914546144114">Log in to the IAM console as the administrator. In the navigation pane, choose <strong id="iam_08_0008__en-us_topic_0272668140_b1192531511515">Identity Providers</strong>.</li><li id="iam_08_0008__en-us_topic_0272668140_li8914046174111">In the IdP list, click <strong id="iam_08_0008__en-us_topic_0272668140_b083214199510">Modify</strong> in the row containing the IdP.</li><li id="iam_08_0008__en-us_topic_0272668140_li9917104619415">In the <strong id="iam_08_0008__en-us_topic_0272668140_b675592216515">Identity Conversion Rules</strong> area, click <strong id="iam_08_0008__en-us_topic_0272668140_b675520220513">Create Rule</strong>. Then, configure the rules in the <strong id="iam_08_0008__en-us_topic_0272668140_b1756182225120">Create Rule</strong> dialog box.<div class="fignone" id="iam_08_0008__en-us_topic_0272668140_fig119361628122210"><span class="figcap"><b>Figure 1 </b>Setting parameters</span><br><span><img id="iam_08_0008__en-us_topic_0272668140_image29361728102218" src="en-us_image_0289500726.png" height="243.83328900000004" width="465.5" title="Click to enlarge" class="imgResize"></span></div>
|
|
<div class="p" id="iam_08_0008__en-us_topic_0272668140_p693203613205">
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="iam_08_0008__en-us_topic_0272668140_table89316364208" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="iam_08_0008__en-us_topic_0272668140_row2093153612208"><th align="left" class="cellrowborder" valign="top" width="14.34%" id="mcps1.3.5.3.1.2.3.5.1.2.4.1.1"><p id="iam_08_0008__en-us_topic_0272668140_p6931236182020">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="21.97%" id="mcps1.3.5.3.1.2.3.5.1.2.4.1.2"><p id="iam_08_0008__en-us_topic_0272668140_p293143672016">Description</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="63.690000000000005%" id="mcps1.3.5.3.1.2.3.5.1.2.4.1.3"><p id="iam_08_0008__en-us_topic_0272668140_p393153613203">Remarks</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="iam_08_0008__en-us_topic_0272668140_row19313642015"><td class="cellrowborder" valign="top" width="14.34%" headers="mcps1.3.5.3.1.2.3.5.1.2.4.1.1 "><p id="iam_08_0008__en-us_topic_0272668140_p39353612018">Username</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.97%" headers="mcps1.3.5.3.1.2.3.5.1.2.4.1.2 "><p id="iam_08_0008__en-us_topic_0272668140_p179333616201">Username of federated users in the cloud platform.</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.690000000000005%" headers="mcps1.3.5.3.1.2.3.5.1.2.4.1.3 "><p id="iam_08_0008__en-us_topic_0272668140_p79310365201">To distinguish federated users from users in the cloud platform, it is recommended that you set the username to <strong id="iam_08_0008__en-us_topic_0272668140_b523071513397">FederationUser-</strong><em id="iam_08_0008__en-us_topic_0272668140_i16232171517391">IdP</em><strong id="iam_08_0008__en-us_topic_0272668140_b18233131593920">_</strong><em id="iam_08_0008__en-us_topic_0272668140_i723411157399">XXX</em>. <em id="iam_08_0008__en-us_topic_0272668140_i13427104114516">IdP</em> indicates an IdP name, for example, AD FS or Shibboleth. <em id="iam_08_0008__en-us_topic_0272668140_i8428104145113">XXX</em> indicates a custom name.</p>
|
|
<div class="notice" id="iam_08_0008__en-us_topic_0272668140_note09317367206"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="iam_08_0008__en-us_topic_0272668140_ul898419111598"><li id="iam_08_0008__en-us_topic_0272668140_li97371147195916">The username of each federated user must be unique in the same IdP. Federated users with the same usernames in the same IdP will be mapped to the same IAM user in the cloud platform.</li><li id="iam_08_0008__en-us_topic_0272668140_li257592617112">The username can only contain letters, digits, spaces, hyphens (-), underscores (_), and periods (.). It cannot start with a digit and cannot contain the following special characters: ", \", \\, \n, \r</li></ul>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="iam_08_0008__en-us_topic_0272668140_row2093103632016"><td class="cellrowborder" valign="top" width="14.34%" headers="mcps1.3.5.3.1.2.3.5.1.2.4.1.1 "><p id="iam_08_0008__en-us_topic_0272668140_p1893183610205">User Groups</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.97%" headers="mcps1.3.5.3.1.2.3.5.1.2.4.1.2 "><p id="iam_08_0008__en-us_topic_0272668140_p189303682010">User groups which the federated users belong to in the cloud platform.</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.690000000000005%" headers="mcps1.3.5.3.1.2.3.5.1.2.4.1.3 "><p id="iam_08_0008__en-us_topic_0272668140_p19319360203">The federated users will inherit permissions from their user groups. You can select a user group that has already been created.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="iam_08_0008__en-us_topic_0272668140_row1793143615209"><td class="cellrowborder" valign="top" width="14.34%" headers="mcps1.3.5.3.1.2.3.5.1.2.4.1.1 "><p id="iam_08_0008__en-us_topic_0272668140_p89363622013">Rule Conditions</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.97%" headers="mcps1.3.5.3.1.2.3.5.1.2.4.1.2 "><p id="iam_08_0008__en-us_topic_0272668140_p79353612203">Conditions that a federated user must meet to obtain permissions from the selected user groups.</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.690000000000005%" headers="mcps1.3.5.3.1.2.3.5.1.2.4.1.3 "><p id="iam_08_0008__en-us_topic_0272668140_p18931936142014">Federated users who do not meet these conditions cannot access the cloud platform. You can create a maximum of 10 conditions for an identity conversion rule.</p>
|
|
<div class="note" id="iam_08_0008__en-us_topic_0272668140_note1931536132016"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="iam_08_0008__en-us_topic_0272668140_ul11932363202"><li id="iam_08_0008__en-us_topic_0272668140_li99353672011">An identity conversion rule can have multiple conditions. It takes effect only if all of the conditions are met.</li><li id="iam_08_0008__en-us_topic_0272668140_li39318367201">An IdP can have multiple identity conversion rules. If a federated user does not meet any of the conditions, the user will be denied to access the cloud platform.</li></ul>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<p id="iam_08_0008__en-us_topic_0272668140_p11452749185811">For example, set an identity conversion rule for administrators in the enterprise management system.</p>
|
|
<ul id="iam_08_0008__en-us_topic_0272668140_ul15501254101813"><li id="iam_08_0008__en-us_topic_0272668140_li12452164914583">Username: <strong id="iam_08_0008__en-us_topic_0272668140_b6658124411279">FederationUser-IdP_admin</strong></li><li id="iam_08_0008__en-us_topic_0272668140_li1745217491580">User group: <strong id="iam_08_0008__en-us_topic_0272668140_b138274233612">admin</strong></li><li id="iam_08_0008__en-us_topic_0272668140_li1550135415185">Rule condition: <strong id="iam_08_0008__en-us_topic_0272668140_b145711451132715">_NAMEID_</strong> (attribute), <strong id="iam_08_0008__en-us_topic_0272668140_b85771851142713">any_one_of</strong> (condition), and <strong id="iam_08_0008__en-us_topic_0272668140_b19577135110274">000000001</strong> (value).<p id="iam_08_0008__en-us_topic_0272668140_p85015431810">Only the user with ID 000000001 is mapped to IAM user <strong id="iam_08_0008__en-us_topic_0272668140_b1811613310543">FederationUser-IdP_admin</strong> and inherits permissions from the <strong id="iam_08_0008__en-us_topic_0272668140_b4117123145411">admin</strong> user group.</p>
|
|
</li></ul>
|
|
</li><li id="iam_08_0008__en-us_topic_0272668140_li10917134614120">In the <strong id="iam_08_0008__en-us_topic_0272668140_b145956236216">Create Rule</strong> dialog box, click <strong id="iam_08_0008__en-us_topic_0272668140_b45951023152112">OK</strong>.</li><li id="iam_08_0008__en-us_topic_0272668140_li1391784674114">On the <strong id="iam_08_0008__en-us_topic_0272668140_b10756152414214">Modify Identity Provider</strong> page, click <strong id="iam_08_0008__en-us_topic_0272668140_b475692416214">OK</strong>.</li></ol>
|
|
</li><li id="iam_08_0008__en-us_topic_0272668140_li35426395309"><strong id="iam_08_0008__en-us_topic_0272668140_b112281550191217">Editing Rules</strong><ol id="iam_08_0008__en-us_topic_0272668140_ol89973613317"><li id="iam_08_0008__en-us_topic_0272668140_li10640142116317">Log in to the IAM console as the administrator. In the navigation pane, choose <strong id="iam_08_0008__en-us_topic_0272668140_b15978311135419">Identity Providers</strong>.</li><li id="iam_08_0008__en-us_topic_0272668140_li04881140121913">In the IdP list, click <strong id="iam_08_0008__en-us_topic_0272668140_b468211512546">Modify</strong> in the row containing the IdP.</li><li id="iam_08_0008__en-us_topic_0272668140_li864032110318">In the <strong id="iam_08_0008__en-us_topic_0272668140_b4312919185415">Identity Conversion Rules</strong> area, click <strong id="iam_08_0008__en-us_topic_0272668140_b731317190543">Edit Rule</strong>.</li><li id="iam_08_0008__en-us_topic_0272668140_li51481932183314">Edit the identity conversion rules in JSON format. For details, see <a href="en-us_topic_0079620340.html">Syntax of Identity Conversion Rules</a>.</li><li id="iam_08_0008__en-us_topic_0272668140_li2042015128518">Click <strong id="iam_08_0008__en-us_topic_0272668140_b13148133352116">Validate</strong> to verify the syntax of the rules.</li><li id="iam_08_0008__en-us_topic_0272668140_li106392307521">If the rule is correct, click <strong id="iam_08_0008__en-us_topic_0272668140_b18786124215393">OK</strong> in the <strong id="iam_08_0008__en-us_topic_0272668140_b17931942123912">Edit Rule</strong> dialog box, and click <strong id="iam_08_0008__en-us_topic_0272668140_b6793124243910">OK</strong> on the <strong id="iam_08_0008__en-us_topic_0272668140_b77951042103912">Modify Identity Provider</strong> page.<p id="iam_08_0008__en-us_topic_0272668140_p1479113445212">If a message indicating that the JSON file is incomplete is displayed, modify the statements or click <strong id="iam_08_0008__en-us_topic_0272668140_b171911335112116">Cancel</strong> to cancel the modifications.</p>
|
|
</li></ol>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="iam_08_0008__en-us_topic_0272668140_section10240138122317"><h4 class="sectiontitle">Verifying Federated User Permissions</h4><p id="iam_08_0008__en-us_topic_0272668140_p453563911617">After configuring identity conversion rules, verify the permissions of federated users.</p>
|
|
<ol id="iam_08_0008__en-us_topic_0272668140_en-us_topic_0175818756_ol344684114811"><li id="iam_08_0008__en-us_topic_0272668140_en-us_topic_0175818756_li986975013551"><span>Log in as a federated user.</span><p><p id="iam_08_0008__en-us_topic_0272668140_en-us_topic_0175818756_p21375325518">On the <strong id="iam_08_0008__en-us_topic_0272668140_b6878195285412">Identity Providers</strong> page of the IAM console, click <strong id="iam_08_0008__en-us_topic_0272668140_b58792052175410">View</strong> in the row containing the IdP. Click <span><img id="iam_08_0008__en-us_topic_0272668140_image687975215548" src="en-us_image_0000001646661553.png"></span> to copy the login link displayed in the <strong id="iam_08_0008__en-us_topic_0272668140_b19879165216543">Basic Information</strong> area, open the link using a browser, and then enter the username and password used in the enterprise management system.</p>
|
|
</p></li><li id="iam_08_0008__en-us_topic_0272668140_en-us_topic_0175818756_li126633555313"><span>Check that the federated user has the permissions assigned to their user group.</span><p><p id="iam_08_0008__en-us_topic_0272668140_en-us_topic_0175818756_p0839596311">For example, configure an identity conversion rule to map federated user <strong id="iam_08_0008__en-us_topic_0272668140_b177171643163918">ID1</strong> to the <strong id="iam_08_0008__en-us_topic_0272668140_b571934311398">admin</strong> user group so that <strong id="iam_08_0008__en-us_topic_0272668140_b1072014314398">ID1</strong> will have full permissions for all cloud services. On the management console, select a cloud service, and check if you can access the service.</p>
|
|
</p></li></ol>
|
|
</div>
|
|
<div class="section" id="iam_08_0008__en-us_topic_0272668140_en-us_topic_0175818756_section4140824420758"><h4 class="sectiontitle">Related Operations</h4><p id="iam_08_0008__en-us_topic_0272668140_p142911642194918">Viewing identity conversion rules: Click <strong id="iam_08_0008__en-us_topic_0272668140_b1381544516210">View Rule</strong> on the <strong id="iam_08_0008__en-us_topic_0272668140_b1282016458217">Modify Identity Provider</strong> page. The identity conversion rules are displayed in JSON format. For details about the JSON format, see <a href="en-us_topic_0079620340.html">Syntax of Identity Conversion Rules</a>.</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="iam_08_0022.html">Virtual User SSO via OpenID Connect</a></div>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
<script language="JavaScript">
|
|
<!--
|
|
image_size('.imgResize');
|
|
var msg_imageMax = "view original image";
|
|
var msg_imageClose = "close";
|
|
//--></script> |