Erstellen einer Vorlage für ein vertrauenswürdiges Profil

Verwenden Sie vertrauenswürdige Profilvorlagen, wenn Benutzer Zugriff auf viele untergeordnete Konten benötigen oder wenn eine Gruppe von Benutzern vorübergehend Zugriff auf mehrere untergeordnete Konten benötigt.

Um eine Vorlage für ein vertrauenswürdiges Profil zu erstellen, führen Sie die folgenden Schritte aus:

1. Gehen Sie zu Verwalten > Zugriff (IAM) > Vorlagen und wählen Sie in der Konsole IBM Cloud die Option Vertrauenswürdige Profile.

2. Klicken Sie auf Erstellen.

3. Geben Sie einen Namen und eine Beschreibung für die vertrauenswürdige Profilvorlage ein, die den Zweck für Unternehmensbenutzer beschreibt.

4. Geben Sie einen Namen, eine E-Mail-Adresse und eine Beschreibung für das vom Unternehmen verwaltete vertrauenswürdige Profil ein, die dessen Zweck für Benutzer von untergeordneten Konten beschreibt, und fügen Sie der Beschreibung unbedingt eine Liste der für dieses vertrauenswürdige Profil verfügbaren Aktionen bei.

   In der E-Mail können Sie entweder eine persönliche E-Mail-ID oder eine Verteilerliste hinzufügen.

   Sie können Ersetzungsvariablen im Profilnamen verwenden, um ihn für jedes Konto individuell anzupassen. Die folgenden Variablen werden unterstützt:

   • ${template_id}: Wird durch einen eindeutigen Bezeichner für die vertrauenswürdige Profilvorlage ersetzt.
   • ${template_name}: Wird durch den aktuellen Namen der vertrauenswürdigen Profilvorlage ersetzt.
   • ${template_version}: Wird durch die aktuelle Version der vertrauenswürdigen Profilvorlage ersetzt.
   • ${account_id}: Wird durch die Kennung des Kontos ersetzt, dem die vertrauenswürdige Profilvorlage zugewiesen ist.
   • ${account_name}: Wird durch den Namen des Kontos ersetzt, dem die vertrauenswürdige Profilvorlage zugewiesen ist.

   Änderungen an Werten wie dem Kontonamen führen nicht zur Aktualisierung des vertrauenswürdigen Profilnamens. Der Profilname wird festgelegt, wenn Sie die Vorlage einem Konto zuweisen oder die Version der Vorlage aktualisieren. Das bedeutet, dass der Profilname nicht automatisch aktualisiert wird, wenn sich der Kontoname später ändert. Der neue Kontoname wird erst verwendet, wenn Sie die Vorlage das nächste Mal zuweisen oder aktualisieren.

5. Klicken Sie auf Erstellen.

Aktualisierung der Vorlagendetails

Sie können den Vorlagennamen, den Namen des vertrauenswürdigen Profils und die Beschreibungen jederzeit aktualisieren, bevor Sie die Vorlage bestätigen. Um die Vorlagendetails zu aktualisieren, führen Sie die folgenden Schritte aus:

1. Gehen Sie zu „Verwalten“ > „Zugriff (IAM)“ > „Vorlagen “.
2. Wählen Sie die vertrauenswürdige Profilvorlage aus, die Sie aktualisieren möchten.
3. Klicken Sie auf das Symbol Bearbeiten im Abschnitt "Details".
4. Nehmen Sie die erforderlichen Aktualisierungen am Vorlagennamen, am Namen des vertrauenswürdigen Profils und an den Beschreibungen vor.
5. Klicken Sie auf Speichern.

Wenn Sie nach dem Festschreiben der Vorlage Aktualisierungen vornehmen müssen, erstellen Sie eine neue Version.

Überprüfung Ihrer Vorlage für das Vertrauensprofil

Überprüfen und bestätigen Sie die vertrauenswürdige Profilvorlage, damit keine weiteren Änderungen an der Version vorgenommen werden können. Auf diese Weise kann der Template Assignment Administrator sicher sein, dass er die Version erst dann zuweist, wenn Sie bestätigt haben, dass sie fertig ist.

1. Klicken Sie auf "Übersicht" > "Überprüfen ".
2. Überprüfen Sie, ob die Vorlage für das vertrauenswürdige Profil Ihren Erwartungen entsprechend konfiguriert ist.
3. Klicken Sie auf das Kontrollkästchen, um zu bestätigen, dass Sie keine Änderungen an der Version vornehmen können.
4. Klicken Sie auf Commit.

Zuweisen einer vertrauenswürdigen Profilvorlage zu untergeordneten Konten

Weisen Sie die vertrauenswürdige Profilvorlage den untergeordneten Konten in Ihrem Unternehmen zu.

Sie können eine IAM-Vorlage nur untergeordneten Konten und Kontengruppen zuweisen, nicht dem Unternehmenskonto.

1. Klicken Sie auf "Konten zuweisen ".

2. Wählen Sie die Konten und Kontengruppen aus, denen Sie die Vorlage zuweisen möchten.

   In jedem der Kinderkonten, denen Sie die Vorlage zuweisen, erstellen Sie ein unternehmensverwaltetes vertrauenswürdiges Profil. Benutzer des Kinderkontos können anhand des unternehmensverwalteten-Tags im Profil feststellen, ob ein vertrauenswürdiges Profil aus einer unternehmensverwalteten IAM-Vorlage stammt.

3. Klicken Sie auf Zuweisen.

Wenn eine Aufgabe fehlschlägt, klicken Sie auf "Wiederholen ".

Neue Version erstellen

Wenn Sie Änderungen an einer vertrauenswürdigen Profilvorlage vornehmen möchten, die festgeschrieben oder zugewiesen ist, erstellen Sie eine neue Version. Sie können eine neue Version auf der Grundlage Ihrer neuesten Version oder einer anderen Version, die Sie auswählen, erstellen.

Um eine neue Version einer vertrauenswürdigen Profilvorlage zu erstellen, führen Sie die folgenden Schritte aus:

1. Wechseln Sie in der „ IBM Cloud “-Konsole zu „Verwalten“ > „Zugriff (IAM)“ > „Vorlagen “.

2. Wählen Sie Ihre bewährte Profilvorlage aus.

3. Klicken Sie auf das Symbol „Neue Version“ .

4. Wählen Sie die Version aus, die Sie als Grundlage für Ihre neue Version verwenden möchten.

5. Geben Sie einen neuen Vorlagennamen und eine neue Beschreibung ein oder behalten Sie die bereits verwendeten bei.

   Durch die Eingabe eines neuen Vorlagennamens wird der Vorlagenname für diese Version und alle vorherigen Versionen aktualisiert. Die Beschreibung der Vorlage wird für jede Version separat gespeichert.

6. Geben Sie einen neuen vertrauenswürdigen Profilnamen und eine Beschreibung ein oder behalten Sie die bereits verwendeten.

   Wenn Sie einen neuen Namen für ein vertrauenswürdiges Profil eingeben, wird der bisherige Name des vertrauenswürdigen Profils ersetzt, der in den Unterkonten angezeigt wird, sobald Sie die neue Version zugewiesen haben.

7. Wählen Sie die Objekte aus, die Sie in Ihre neue Version übertragen möchten.

   1. (Optional) Wählen Sie Vertrauensbeziehungen aus.
   2. (Optional) Wählen Sie "Zugriff ".

8. Klicken Sie auf Erstellen.

9. Nehmen Sie gegebenenfalls weitere Anpassungen an der Konfiguration vor.

10. Klicken Sie auf "Überprüfen" und geben Sie die neue Version frei. Weitere Informationen finden Sie unter "Überprüfung Ihrer vertrauenswürdigen Profilvorlage ".

Um eine neue Version einer vertrauenswürdigen Profilvorlage zuzuweisen, führen Sie die folgenden Schritte aus:

1. Wechseln Sie in der „ IBM Cloud “-Konsole zu „Verwalten“ > „Zugriff (IAM)“ > „Vorlagen “.
2. Klicken Sie auf "Vertrauenswürdige Profile ".
3. Klicken Sie auf das Symbol zum Erweitern der Tabelle anhand der Vorlage, mit der Sie arbeiten möchten.
4. Wählen Sie die Version aus, die derzeit den untergeordneten Konten zugewiesen ist.
5. Klicken Sie auf "Aufgaben ".
6. Klicken Sie auf "Aktualisieren" in der Konto- oder Kontogruppenzuweisung, der Sie eine andere Version zuweisen möchten.
7. Klicken Sie auf „ Version auswählen “.
   1. Wählen Sie die Version aus, die Sie durch die aktuelle Version ersetzen möchten.
8. Klicken Sie auf Aktualisieren.
9. Wiederholen Sie diese Schritte für jedes Konto oder jede Kontengruppe, dem/der Sie eine andere Version zuweisen möchten.

Die neue Vorlagenversion, die Sie zuweisen, ersetzt die alte Version. Erfahren Sie mehr über das Zuweisen einer neuen Version.

Aufgabe entfernen

Sie können eine Vorlagenzuweisung von einem oder mehreren Konten entfernen, denen die Vorlage zugewiesen ist. Dies ist möglicherweise sinnvoll, wenn die Vorlage nicht wie vorgesehen funktioniert. Wenn Sie eine Vorlagenzuweisung aus einem Konto entfernen, wird standardmäßig die vorherige Version der Vorlage wiederhergestellt. Wenn die Aufgabe, die Sie entfernen, für die erste oder einzige Version einer Vorlage gilt, wird das vertrauenswürdige Profil im untergeordneten Konto entfernt.

Um eine Zuweisung zu entfernen, führen Sie die folgenden Schritte aus:

1. Wechseln Sie in der „ IBM Cloud “-Konsole zu „Verwalten“ > „Zugriff (IAM)“ > „Vorlagen “.
2. Klicken Sie auf "Vertrauenswürdige Profile " und wählen Sie Ihre vertrauenswürdige Profilvorlage aus.
3. Klicken Sie auf "Aufgaben aktualisieren ".
   1. Um eine Zuweisung von einem oder mehreren Konten zu entfernen, deaktivieren Sie die Konten, bei denen Sie die Vorlagenzuweisung entfernen möchten.
   2. Um eine Aufgabe aus allen Konten zu entfernen, denen die Vorlage zugewiesen ist, klicken Sie auf "Alle Zuweisungen aufheben ".

Erstellen einer vertrauenswürdigen Profilvorlage mithilfe der Befehlszeilenschnittstelle

Verwenden Sie vertrauenswürdige Profilvorlagen, wenn Sie viele untergeordnete Konten haben, für die dasselbe vertrauenswürdige Profil erforderlich ist. Beispielsweise könnte Ihre Organisation interne Standards haben oder die Einhaltung von Branchenvorschriften verlangen.

Um mithilfe der CLI eine Vorlage für ein vertrauenswürdiges Profil zu erstellen, führen Sie die folgenden Schritte aus:

1. Erstellen Sie eine JSON-Datei, die die Definition der vertrauenswürdigen Profilvorlage konfiguriert. Weitere Informationen zu den Attributen, die Sie in Ihrer JSON-Datei verwenden können, finden Sie in der IAM-Identitäts-API.

   Die folgende JSON-Beispieldatei gibt die account_id des Unternehmenskontos, die name der Vorlage und die profile-Konfiguration an. Dieses vertrauenswürdige Profil ist für Datenbankadministratoren. Ein bestimmter Benutzer darf die Vorlage anwenden, wie in identities definiert. rules ist ebenfalls definiert, das den Zugriff auf das Profil auf der Grundlage von SAML Attributen gewährt.

      {
      "account_id": "5bbe28be34524sdbdaa34d37d1f2294a",
      "name": "dbadmintemplate",
      "profile": {
         "name": "Profile for DB Admins",
         "description": "allows users to admin db instances",
         "identities": [
               {
                  "type": "user",
                  "identifier": "IBMid-123456789",
                  "accounts": [
                     "5bbe28be34524sdbdaa34d37d1f2294a"
                  ]
               }
         ],
         "rules": [
               {
                  "type": "Profile",
                  "realm_name": "${IDP_REALM_NAME}",
                  "expiration": 43200,
                  "conditions": [
                     {
                           "claim": "group",
                           "operator": "EQUALS",
                           "value": "\"admins\""
                     }
                  ]
               }
         ]
      },
      "policy_template_references": [
         {
               "id": "Policy Template-12345",
               "version": 1
         }
      ]
   }
   

2. Erstellen Sie die vertrauenswürdige Profilvorlage, indem Sie den Befehl trusted-profile-template-create verwenden, wie in der folgenden Beispielanfrage dargestellt:

   ibmcloud iam trustedprofile-template-create dbadmintemplate --file /path/to/db_trusted-profile_template.json
   

Aktualisieren einer vertrauenswürdigen Profilvorlage mithilfe der Befehlszeilenschnittstelle

Sie können eine vertrauenswürdige Profilvorlage jederzeit aktualisieren, bevor Sie sie bestätigen. Um eine bestimmte Version einer vertrauenswürdigen Profilvorlage zu aktualisieren, führen Sie die folgenden Schritte aus:

1. Aktualisieren Sie Ihre JSON-Datei mit der neuen Definition der vertrauenswürdigen Profilvorlage. Weitere Informationen zu den Attributen, die Sie in Ihrer JSON-Datei verwenden können, finden Sie in der IAM-Identitäts-API.

     {
     "account_id": "5bbe28be34524sdbdaa34d37d1f2294a",
     "name": "DBAdministrator",
     "profile": {
        "name": "Profile for DB Admins",
        "description": "allows users to admin db instances",
        "identities": [
              {
                 "type": "user",
                 "identifier": "IBMid-123456789",
                 "accounts": [
                    "5bbe28be34524sdbdaa34d37d1f2294a"
                 ]
              }
        ],
        "rules": [
              {
                 "type": "Profile",
                 "realm_name": "${IDP_REALM_NAME}",
                 "expiration": 43200,
                 "conditions": [
                    {
                          "claim": "group",
                          "operator": "EQUALS",
                          "value": "\"admins\""
                    }
                 ]
              }
        ]
     },
     "policy_template_references": [
        {
              "id": "Policy Template-12345",
              "version": 1
        }
     ]
   }
   

 Wenn Sie den Namen der Vorlage aktualisieren, wird der Name für jede Version aktualisiert.
 {: note}

  1. Um eine bestimmte Version einer vertrauenswürdigen Profilvorlage zu aktualisieren, verwenden Sie den Befehl `trusted-profile-template-version-update`, wie in der folgenden Beispielanfrage dargestellt:

 ```bash {: codeblock}
 ibmcloud iam trustedpprofile-template-version-update DBAdministrator 1 --file /path/to/db_trusted-profile_template.json

## Zuweisen einer vertrauenswürdigen Profilvorlage mithilfe der Befehlszeilenschnittstelle
{: #commit-trusted-profile-template-cli cli}

Überprüfen Sie die Vorlage für das vertrauenswürdige Profil und bestätigen Sie sie, damit keine weiteren Änderungen an der Version vorgenommen werden können. Das Festlegen einer Version ist ein notwendiger Schritt, bevor Sie sie untergeordneten Konten zuweisen können. Auf diese Weise kann der Template Assignment Administrator sicher sein, dass er die Version erst dann zuweist, wenn Sie bestätigt haben, dass sie fertig ist.

Die folgende Beispielanforderung verpflichtet die Version `1` der vertrauenswürdigen Profilvorlage mit dem Namen `DBAdministrator`:

```bash {: codeblock}

ibmcloud iam trusted-profile-template-version-commit DBAdministrator 1

  ## Zuweisen einer vertrauenswürdigen Profilvorlage zu untergeordneten Konten mithilfe der Befehlszeilenschnittstelle
  {: #assign-trusted-profile-template-cli cli}

  Weisen Sie die vertrauenswürdige Profilvorlage den untergeordneten Konten in Ihrem Unternehmen zu.

  Sie können eine IAM-Vorlage nur untergeordneten Konten und Kontengruppen zuweisen, nicht dem Unternehmenskonto.
  {: note}

  Um eine Aufgabe für eine vertrauenswürdige Profilvorlage zu erstellen, führen Sie die folgenden Schritte aus:
  1. Listen Sie die vertrauenswürdigen Profilvorlagen in Ihrem Unternehmenskonto auf und notieren Sie sich den Namen der Vorlage und die Versionsnummer für die vertrauenswürdige Profilvorlage, die Sie den untergeordneten Konten zuweisen möchten:

 ```bash {: codeblock}
 ibmcloud iam trusted-profile-templates

1. Weisen Sie die Vorlage einer `Account` oder `AccountGroup` zu, indem Sie den Befehl `account-trusted profile-assignment-create` verwenden.

ibmcloud iam trusted-profile-assignment-create DBAdministrator 1 AccountGroup 955fc2274567474f8da802d5c376504b

Wenn eine Aufgabe fehlschlägt, versuchen Sie es erneut über `trusted-profile-assignment-update`.
{: tip}

## Erstellen einer neuen Version über die Befehlszeilenschnittstelle (CLI)
{: #new-version-trusted-profile-template cli}

Wenn Sie Änderungen an einer vertrauenswürdigen Profilvorlage vornehmen möchten, die festgeschrieben oder zugewiesen ist, erstellen Sie eine neue Version.

1. Aktualisieren Sie Ihre JSON-Datei mit der neuen Definition der vertrauenswürdigen Profilvorlage. Weitere Informationen zu den Attributen, die Sie in Ihrer JSON-Datei verwenden können, finden Sie in [der IAM-Identitäts-API](/docs/apis/iam-identity-token-api#create-profile-template-version).
1. Verwenden Sie die `trusted-profile-template-version-create`-Methode, um eine neue Version zu erstellen. Die folgende Beispielanfrage erstellt eine neue Version der Vorlage `DBAdministrator`.

ibmcloud iam trusted-profile-template-version-create DBAdministrator --file /path/to/db_trusted-profile_template.json

## Eine Zuweisung über die Befehlszeilenschnittstelle aktualisieren
{: #update-assignment-trusted-profile-cli cli}

Aktualisieren Sie eine Aufgabe, um sie auf eine neue Version zu migrieren, oder wiederholen Sie eine fehlgeschlagene Aufgabe.

Die neue Vorlagenversion, die Sie zuweisen, ersetzt die alte Version. Erfahren Sie mehr über [das Zuweisen einer neuen Version](/docs/enterprise-management?topic=enterprise-management-working-with-versions#new-version).
{: note}

1. Listen Sie die Zuweisungen vertrauenswürdiger Profile in Ihrem Unternehmenskonto auf und notieren Sie sich die E-Mail-Adresse `template_id` für die Zuweisung, die Sie aktualisieren möchten:

ibmcloud iam trusted-profile-assignments

1. Aktualisieren Sie die Zuordnung des vertrauenswürdigen Profils. Wenn Sie einen Auftrag erneut versuchen, verwenden Sie dieselbe Versionsnummer. Die folgende Beispielanforderung migriert die Zuweisung `ProfileTemplate-cac1b203-5956-4981-bdec-0a4af4feab4d` auf Version 2.

ibmcloud iam trusted-profile-assignment-update ProfileTemplate-cac1b203-5956-4981-bdec-0a4af4feab4d 2

## Eine Zuordnung über die Befehlszeilenschnittstelle entfernen
{: #remove-assignment-trusted-profile-cli cli}

Sie können eine Vorlagenzuweisung aus einem Konto oder einer Kontogruppe entfernen, dem bzw. der die Vorlage zugewiesen ist. Dies ist möglicherweise sinnvoll, wenn die Vorlage nicht wie vorgesehen funktioniert. Wenn Sie eine Vorlagenzuweisung aus einem Konto entfernen, wird standardmäßig die vorherige Version der Vorlage wiederhergestellt. Wenn die Aufgabe, die Sie entfernen, für die erste oder einzige Version einer Vorlage gilt, wird das unternehmensverwaltete vertrauenswürdige Profil im untergeordneten Konto entfernt.

Um eine Zuweisung zu entfernen, führen Sie die folgenden Schritte aus:

1. Führen Sie die Aufträge im Konto nach der `account-trusted profile-assignments`-Methode auf. Notieren Sie sich die E-Mail-Adresse `ASSIGNMENT_ID` für die Aufgabe, die Sie entfernen möchten.
1. Entfernen Sie die Aufgabe mithilfe der `account-trusted profile-assigment-delete`-Methode. Die folgende Beispielanfrage entfernt die Zuweisung `AccountSettingsAssignment-63d65ed159ff463b8ec09ea77d22a05b`.

ibmcloud iam account-trusted profile-assignment-delete AccountSettingsAssignment-63d65ed159ff463b8ec09ea77d22a05b

## Eine Version über die Befehlszeilenschnittstelle löschen
{: #delete-trusted-profile-template-version-cli cli}

Bevor Sie eine vertrauenswürdige Profilvorlagenversion löschen können, müssen Sie alle Zuweisungen für diese Version der Vorlage entfernen. Führen Sie die folgenden Schritte aus, um eine bestimmte Version zu löschen:

1. Listen Sie die vertrauenswürdigen Profilvorlagen in Ihrem Unternehmenskonto auf und notieren Sie sich den Namen der Vorlage und die Versionsnummer für die Version, die Sie löschen möchten:

ibmcloud iam account-trusted profile-templates

1. Version löschen:

ibmcloud iam account-trusted profile-template-delete AccountSettingsTemplateUpdated 2

1. Um alle Versionen zu löschen, wiederholen Sie diese Schritte. Stellen Sie sicher, dass Sie zuerst die Zuweisungen für jede Version entfernen.

## Erstellen einer vertrauenswürdigen Profilvorlage mithilfe der API
{: #create-trusted-profile-template-api api}

Verwenden Sie vertrauenswürdige Profilvorlagen, wenn Sie viele untergeordnete Konten haben, für die dasselbe vertrauenswürdige Profil erforderlich ist. Beispielsweise könnte Ihre Organisation interne Standards haben oder die Einhaltung von Branchenvorschriften verlangen.

Führen Sie die folgenden Schritte aus, um mithilfe der API eine vertrauenswürdige Profilvorlage zu erstellen:

1. Konfigurieren Sie die Definition der vertrauenswürdigen Profilvorlage. Weitere Informationen zu den Attributen, die Sie verwenden können, finden Sie in [der IAM-Identitäts-API](/docs/apis/iam-identity-token-api#create-profile-template).

Im folgenden Beispiel werden die account_id des Unternehmenskontos, die name der Vorlage und die profile-Konfiguration angegeben. Dieses vertrauenswürdige Profil ist für Datenbankadministratoren. Ein bestimmter Benutzer darf die Vorlage anwenden, wie in identities definiert. rules ist ebenfalls definiert, das den Zugriff auf das Profil auf der Grundlage von SAML Attributen gewährt.

   {
   "account_id": "5bbe28be34524sdbdaa34d37d1f2294a",
   "name": "dbadmintemplate",
   "profile": {
      "name": "Profile for DB Admins",
      "description": "allows users to admin db instances",
      "identities": [
            {
               "type": "user",
               "identifier": "IBMid-123456789",
               "accounts": [
                  "5bbe28be34524sdbdaa34d37d1f2294a"
               ]
            }
      ],
      "rules": [
            {
               "type": "Profile",
               "realm_name": "${IDP_REALM_NAME}",
               "expiration": 43200,
               "conditions": [
                  {
                        "claim": "group",
                        "operator": "EQUALS",
                        "value": "\"admins\""
                  }
               ]
            }
      ]
   },
   "policy_template_references": [
      {
            "id": "Policy Template-12345",
            "version": 1
      }
   ]
}

   ProfileClaimRuleConditions condition = new ProfileClaimRuleConditions.Builder()
      .claim("blueGroups")
      .operator("EQUALS")
      .value("\"cloud-docs-dev\"")
      .build();
   List<ProfileClaimRuleConditions> conditions = new ArrayList<>();
   conditions.add(condition);
   TrustedProfileTemplateClaimRule claimRule = new TrustedProfileTemplateClaimRule.Builder()
      .name("My Rule")
      .realmName(realmName)
      .type(claimRuleType)
      .expiration(43200)
      .conditions(conditions)
      .build();
   TemplateProfileComponentRequest profile = new TemplateProfileComponentRequest.Builder()
      .addRules(claimRule)
      .name(profileTemplateProfileName)
      .description("Trusted profile created from a template")
      .build();
   CreateProfileTemplateOptions createProfileTemplateOptions = new CreateProfileTemplateOptions.Builder()
      .name(profileTemplateName)
      .description("IAM enterprise trusted profile template example")
      .accountId(enterpriseAccountId)
      .profile(profile)
      .build();
   Response<TrustedProfileTemplateResponse> response = service.createProfileTemplate(createProfileTemplateOptions).execute();
   TrustedProfileTemplateResponse trustedProfileTemplateResult = response.getResult();
   // Save the id for use by other test methods.
   profileTemplateId = trustedProfileTemplateResult.getId();
   profileTemplateVersion = trustedProfileTemplateResult.getVersion().longValue();
   System.out.println(trustedProfileTemplateResult);
   ```
   ```javascript {: javascript codeblock}
   const condition = {
   claim: "blueGroups",
   operator: "EQUALS",
   value: "\"cloud-docs-dev\"",
   }
   const claimRule = {
      name: "My Rule",
      realm_name: realmName,
      type: 'Profile-SAML',
      expiration: 43200,
      conditions: [condition],
   }
   const profile = {
   rules: [claimRule],
   name: "Profile-From-Example-Template",
   description: "Trusted profile created from a template",
   }
   const templateParams = {
   name: "Example-Profile-Template",
   description: "IAM enterprise trusted profile template example",
   accountId: enterpriseAccountId,
   profile: profile,
   }
   try {
   const res = await iamIdentityService.createProfileTemplate(templateParams);
   profileTemplateEtag = res.headers.etag;
   const { result } = res;
   profileTemplateId = result.id;
   profileTemplateVersion = result.version;
   console.log(JSON.stringify(result, null, 2));
   } catch (err) {
   console.warn(err);
   }
   ```
   ```python {: python codeblock}
   profile_claim_rule_conditions = {}
   profile_claim_rule_conditions['claim'] = 'blueGroups'
   profile_claim_rule_conditions['operator'] = 'EQUALS'
   profile_claim_rule_conditions['value'] = '\"cloud-docs-dev\"'
   profile_claim_rule = {}
   profile_claim_rule['name'] = 'My Rule'
   profile_claim_rule['realm_name'] = 'https://sdk.test.realm/1234'
   profile_claim_rule['type'] = 'Profile-SAML'
   profile_claim_rule['expiration'] = 43200
   profile_claim_rule['conditions'] = [profile_claim_rule_conditions]
   profile = {}
   profile['name'] = 'Profile-From-Example-Template'
   profile['description'] = 'Trusted profile created from a template'
   profile['rules'] = [profile_claim_rule]
   create_response = iam_identity_service.create_profile_template(
   name='Example-Profile-Template',
   description='IAM enterprise trusted profile template example',
   account_id=enterprise_account_id,
   profile=profile,
   )
   profile_template = create_response.get_result()
   print('\ncreate_profile_template() response: ', json.dumps(profile_template, indent=2))
   global profile_template_id
   profile_template_id = profile_template['id']
   global profile_template_version
   profile_template_version = profile_template['version']
   ```
   ```go {: go codeblock}
   profileClaimRuleConditions := new(iamidentityv1.ProfileClaimRuleConditions)
   profileClaimRuleConditions.Claim = core.StringPtr("blueGroups")
   profileClaimRuleConditions.Operator = core.StringPtr("EQUALS")
   profileClaimRuleConditions.Value = core.StringPtr("\"cloud-docs-dev\"")
   profileTemplateClaimRule := new(iamidentityv1.TrustedProfileTemplateClaimRule)
   profileTemplateClaimRule.Name = core.StringPtr("My Rule")
   profileTemplateClaimRule.RealmName = &realmName
   profileTemplateClaimRule.Type = &claimRuleType
   profileTemplateClaimRule.Expiration = core.Int64Ptr(int64(43200))
   profileTemplateClaimRule.Conditions = []iamidentityv1.ProfileClaimRuleConditions{*profileClaimRuleConditions}
   profile := new(iamidentityv1.TemplateProfileComponentRequest)
   profile.Name = &profileTemplateProfileName
   profile.Description = core.StringPtr("Example Profile created from Profile Template")
   profile.Rules = []iamidentityv1.TrustedProfileTemplateClaimRule{*profileTemplateClaimRule}
   createOptions := &iamidentityv1.CreateProfileTemplateOptions{
   Name:        &profileTemplateName,
   Description: core.StringPtr("Example Profile Template"),
   AccountID:   &enterpriseAccountID,
   Profile:     profile,
   }
   createResponse, response, err := iamIdentityService.CreateProfileTemplate(createOptions)
   b, _ := json.MarshalIndent(createResponse, "", "  ")
   fmt.Println(string(b))
   // Grab the ID and Etag value from the response for use in the update operation
   profileTemplateId = *createResponse.ID
   profileTemplateVersion = *createResponse.Version
   profileTemplateEtag = response.GetHeaders().Get("Etag")
   ```
 Speichern Sie den Wert von ProfileTemplate ID und entity_tag aus der Antwort für die Verwendung in Aktualisierungsvorgängen.
 { tip}

 ## Aktualisieren einer vertrauenswürdigen Profilvorlage mithilfe der API
 {: #update-trusted-profile-template-api api}

 Sie können eine vertrauenswürdige Profilvorlage jederzeit aktualisieren, bevor Sie sie bestätigen. Weitere Informationen zu den Attributen, die Sie in Ihrer JSON-Datei verwenden können, finden Sie in [der IAM-Identitäts-API](/docs/apis/iam-identity-token-api#update-profile-template-version). Um eine bestimmte Version einer vertrauenswürdigen Profilvorlage zu aktualisieren, führen Sie die folgenden Schritte aus:

 1. Listen Sie die vertrauenswürdigen Profilvorlagen in Ihrem Unternehmenskonto auf und notieren Sie die `ProfileTemplate`-ID und den ETag in der Antwort für die Vorlagenversion, die Sie aktualisieren möchten.

```bash {: curl codeblock}
curl -X GET 'https://iam.cloud.ibm.com/v1/profile_templates?account_id=5bbe28be34524sdbdaa34d37d1f2294a' -H 'Content-Type: application/json' -H 'Authorization: Bearer $TOKEN'

ListProfileTemplatesOptions listOptions = new ListProfileTemplatesOptions.Builder()
   .accountId(enterpriseAccountId)
   .build();
Response<TrustedProfileTemplateList> response = service.listProfileTemplates(listOptions).execute();
TrustedProfileTemplateList listResult = response.getResult();
System.out.println(listResult);

const params = {
accountId: enterpriseAccountId,
}
try {
const res = await iamIdentityService.listProfileTemplates(params);
console.log(JSON.stringify(res.result, null, 2));
} catch (err) {
console.warn(err);
}

list_response = iam_identity_service.list_profile_templates(account_id=enterprise_account_id)
profile_template_list = list_response.get_result()
print('\nlist_profile_templates response: ', json.dumps(profile_template_list, indent=2))

listOptions := &iamidentityv1.ListProfileTemplatesOptions{
AccountID: &enterpriseAccountID,
}
listResponse, response, err := iamIdentityService.ListProfileTemplates(listOptions)
b, _ := json.MarshalIndent(listResponse, "", "  ")
fmt.Println(string(b))

1. Aktualisieren Sie die Definition der vertrauenswürdigen Profilvorlage.

```bash {: curl codeblock}

curl -X PUT 'https://iam.cloud.ibm.com/v1/profile_templates/{template_id}/versions/{version}' -H 'Content-Type: application/json' -H 'Authorization: Bearer $TOKEN' -d '{ "account_id": "5bbe28be34524sdbdaa34d37d1f2294a", "name": "db admin template", "profile": { "name": "Profile for DB Admins", "description": "allows users to admin db instances", "rules": [ { "type": "Profile", "realm_name": "${IDP_REALM_NAME}", "expiration": 43200, "conditions": [ { "claim": "name", "operator": "EQUALS", "value": ""My Name"" } ] } ] }, "policy_template_references": [ { "id": "Policy Template-12345", "version": 1 } ] }'

 ```java {: java codeblock}
 UpdateProfileTemplateVersionOptions updateOptions = new UpdateProfileTemplateVersionOptions.Builder()
    .accountId(enterpriseAccountId)
    .templateId(profileTemplateId)
    .version(Long.toString(profileTemplateVersion))
    .ifMatch(profileTemplateEtag)
    .name(profileTemplateName)
    .description("IAM enterprise trusted profile template example - updated")
    .build();
 Response<TrustedProfileTemplateResponse> updateResponse = service.updateProfileTemplateVersion(updateOptions).execute();
 TrustedProfileTemplateResponse updateResult = updateResponse.getResult();
 // Grab the Etag value from the response for use in the update operation.
 profileTemplateEtag = updateResponse.getHeaders().values("Etag").get(0);
 System.out.println(updateResult);

const params = {
accountId: enterpriseAccountId,
templateId: profileTemplateId,
version: profileTemplateVersion,
ifMatch: profileTemplateEtag,
name: "Example-Profile-Template",
description: "IAM enterprise trusted profile template example - updated",
}
try {
const res = await iamIdentityService.updateProfileTemplateVersion(params);
profileTemplateEtag = res.headers.etag;
console.log(JSON.stringify(res.result, null, 2));
} catch (err) {
console.warn(err);
}

{
"id": "ProfileTemplate-767fc1f6-c77c-4196-b3d6-a009a5a536e9",
"version": 1,
"account_id": "5bbe28be34524sdbdaa34d37d1f2294a",
"name": "db admin template",
"committed": false,
"profile": {
   "name": "Profile for DB Admins",
   "description": "allows users to admin db instances",
   "rules": [
      {
      "type": "Profile-SAML",
      "realm_name": "${IDP_REALM_NAME}",
      "expiration": 43200,
      "conditions": [
         {
            "claim": "name",
            "operator": "EQUALS",
            "value": "\"My Name\""
         }
      ]
      }
   ]
},
"policy_template_references": [
   {
      "id": "Policy Template-12345",
      "version": "1"
   }
],
"created_at": "2023-03-07T13:55:33:428+0000",
"created_by_id": "IBMid-12345678901",
"last_modified_at": "2023-03-07T13:55:33:428+0000",
"last_modified_by_id": "IBMid-12345678901",
"entity_tag": "1-2da85a8f1172fc3527378318d3182778",
"crn": "crn:v1:staging:public:iam-identity::a/5bbe28be34524sdbdaa34d37d1f2294a::template:ProfileTemplate-767fc1f6-c77c-4196-b3d6-a009a5a536e9"
}

{
"id": "ProfileTemplate-767fc1f6-c77c-4196-b3d6-a009a5a536e9",
"version": 1,
"account_id": "5bbe28be34524sdbdaa34d37d1f2294a",
"name": "db admin template",
"committed": false,
"profile": {
   "name": "Profile for DB Admins",
   "description": "allows users to admin db instances",
   "rules": [
      {
      "type": "Profile-SAML",
      "realm_name": "${IDP_REALM_NAME}",
      "expiration": 43200,
      "conditions": [
         {
            "claim": "name",
            "operator": "EQUALS",
            "value": "\"My Name\""
         }
      ]
      }
   ]
},
"policy_template_references": [
   {
      "id": "Policy Template-12345",
      "version": "1"
   }
],
"created_at": "2023-03-07T13:55:33:428+0000",
"created_by_id": "IBMid-12345678901",
"last_modified_at": "2023-03-07T13:55:33:428+0000",
"last_modified_by_id": "IBMid-12345678901",
"entity_tag": "1-2da85a8f1172fc3527378318d3182778",
"crn": "crn:v1:staging:public:iam-identity::a/5bbe28be34524sdbdaa34d37d1f2294a::template:ProfileTemplate-767fc1f6-c77c-4196-b3d6-a009a5a536e9"
}

Wenn Sie den Namen der Vorlage aktualisieren, wird der Name für jede Version aktualisiert.