Complete the Add Account Partner Wizard

  • Article

Applies To: Windows Server 2003 R2

You can use the Add Account Partner Wizard to add a new account partner manually or by importing a policy file. This will allow user accounts in the account partner to access Web applications that are protected by this Federation Service.

Add an account partner manually

You can use the following procedure to add an account partner manually.

To add an account partner manually

  1. Click Start, point to Administrative Tools, and then click Active Directory Federation Services.

  2. In the console tree, double-click Federation Service, Trust Policy, and Partner Organizations.

  3. Right-click Account Partners, point to New, and then click Account Partner.

  4. On the Welcome to the Add Account Partner Wizard page, click Next.

  5. On the Import Policy File page, click No, and then click Next.

  6. On the Account Partner Details page, do the following, and then click Next

    • In Display name, type the display name of the account partner.

    • In Federation Service URI, type the Uniform Resource Identifier (URI) of the Federation Service.

    • In Federation Service endpoint URL, type the Uniform Resource Locator (URL) of the Federation Service.

  7. On the Account Partner Verification Certificate page, type the path to the verification certificate, or browse to it, and then click Next.

  8. On the Federation Scenario page, do one of the following, and then click Next:

    • If you are establishing a federated trust with another organization or you do not want to use an existing forest trust, click Federated Web SSO, and then go to step 10.

    • If you are establishing a federated trust within the same organization when both sides already share a forest trust, click Federated Web SSO with Forest Trust.

  9. On the Federated Web SSO with Forest Trust page, do one of the following, and then click Next:

    • To accept users in all domains that are trusted by the account partner, click All Active Directory domains and forests. Any user that can authenticate to the account partner will be accepted.

    • To accept user accounts that are located in some of the domains that are trusted by the account partner, click The following Active Directory domains and forests. Then, in New, trusted Active Directory domain or forest, type the name of a domain or forest, and then click Add. Only users from the specified domains will be accepted.

  10. On the Account Partner Identity Claims page, select one or more identity claims to share with the resource partner, and then click Next:

    • If the resource partner requires user principal name (UPN) claims to make authorization decisions, select the UPN Claim check box.

    Important

    When UPN claims or e-mail claims are used to make authorization decisions, it is essential that each account partner use a unique UPN suffix or e-mail suffix. If two account partners use the same UPN suffix or e-mail suffix, it may not be possible to uniquely identify users. This condition might allow a user from one account partner to receive the permissions that are intended for a user in another account partner. This condition might also introduce a significant security weakness because an administrator could intentionally create user accounts to impersonate users from one of your other account partners.

    Note

    If you selected the Federated Web SSO with Forest Trust scenario, the UPN Claim option is selected and not configurable. This is because UPN claims are required for this scenario.

    • If the resource partner requires e-mail claims to make authorization decisions, select the E-mail Claim check box.

    • If the resource partner requires common name claims to make authorization decisions, select the Common Name Claim check box.

  11. If you selected UPN Claim as an identity claim, on the Accepted UPN Suffixes page, click All UPN suffixes (this option is available only if you selected the Federation Web SSO with Forest Trust option), or type the accepted suffix, click Add, and then click Next.

  12. If you selected E-mail Claim as an identity claim, on the Accepted E-mail Suffixes page, click All E-mail suffixes (this option is available only if you selected the Federation Web SSO with Forest Trust option), or type the accepted suffix, click Add, and then click Next.

    Note

    Common name claims require no additional information.

  13. On the Enable this Account Partner page, if you do not want to enable the account partner now, clear the Enable this account partner check box, and then click Next.

  14. To add the new account partner and close the wizard, click Finish.

Add an account partner by importing a policy file

You can use the following procedure to add an account partner by importing a policy file.

To add an account partner by importing a policy file

  1. Click Start, point to Administrative Tools, and then click Active Directory Federation Services.

  2. In the console tree, double-click Federation Service, Trust Policy, and Partner Organizations.

  3. Right-click Account Partners, point to New, and then click Account Partner.

  4. On the Welcome to the Add Account Partner Wizard page, click Next.

  5. On the Import Policy File page, do the following, and then click Next:

    • Click Yes.

    • In Partner interoperability policy file, browse to or type the location of the account partner policy file.

  6. On the Federation Scenario page, do one of the following, and then click Next:

    • If you are establishing a federated trust with another organization or you do not want to use an existing forest trust, click Federated Web SSO, and then go to step 8.

    • If you are establishing a federated trust within the same organization when both sides already share a forest trust, click Federated Web SSO with Forest Trust.

  7. On the Federation Web SSO with Forest Trust page, do one of the following, and then click Next:

    • To accept users in all domains that are trusted by the account partner, click All Active Directory domains and forests. Any user that can authenticate to the account partner will be accepted.

    • To accept user accounts that are located in some of the domains that are trusted by the account partner, click The following Active Directory domains and forests. Then, in New, trusted Active Directory domain or forest, type the name of the domain or forest, and then click Add. Only users from the specified domains will be accepted.

  8. On the Account Partner Identity Claims page, select one or more identity claims that this partner will provide, and then click Next:

    • If the resource partner requires UPN claims to make authorization decisions, select the UPN Claim check box.

    Important

    When UPN claims or e-mail claims are used to make authorization decisions, it is essential that each account partner use a unique UPN suffix or e-mail suffix. If two account partners use the same UPN suffix or e-mail suffix, it may not be possible to uniquely identify users. This condition might allow a user from one account partner to receive the permissions that are intended for a user in another account partner. This condition might also introduce a significant security weakness because an administrator could intentionally create user accounts to impersonate users from one of your other account partners.

    Note

    If you selected the Federated Web SSO with Forest Trust scenario, the UPN Claim option is selected and not configurable. This is because UPN claims are required for this scenario.

    • If the resource partner requires e-mail claims to make authorization decisions, select the E-mail Claim check box.

    • If the resource partner requires common name claims to make authorization decisions, select the Common Name Claim check box.

  9. If you selected UPN Claim as an identity claim, on the Accepted UPN Suffixes page, click All UPN suffixes (this option is available only if you selected the Federation Web SSO with Forest Trust option), or type the accepted suffixes, click Add, and then click Next.

  10. If you selected E-mail Claim as an identity claim, on the Accepted E-mail Suffixes page, click All E-mail suffixes (this option is available only if you selected the Federation Web SSO with Forest Trust option), or type the accepted suffix, click Add, and then click Next.

    Note

    Common name claims require no additional information.

  11. On the Enable this Account Partner page, if you do not want to enable the account partner now, clear the Enable this account partner check box, and then click Next.

  12. To add the new account partner and close the wizard, click Finish.

Rename an imported account partner

You can use the following procedure to rename an imported account partner.

To rename an imported account partner

  1. Click Start, point to Administrative Tools, and then click Active Directory Federation Services.

  2. In the console tree, double-click Federation Service, Trust Policy, Partner Organizations, and Account Partners.

  3. Right-click the account partner, and then click Rename.

  4. Type a new name for account partner.