Deploy Claims Across Forests (Demonstration Steps)

Applies To: Windows Server 2012

In this topic, we’ll cover a basic scenario that explains how to configure claims transformations between trusting and trusted forests. You will learn how claims transformation policy objects can be created and linked to the trust on the trusting forest and the trusted forest. You will then validate the scenario.

Scenario overview

Adatum Corporation provides financial services to Contoso, Ltd. Each quarter, Adatum accountants copy their account spreadsheets to a folder on a file server located at Contoso, Ltd. There is a two-way trust set up from Contoso to Adatum. Contoso, Ltd. wants to protect the share so that only Adatum employees can access the remote share.

In this scenario:

1. Set up the prerequisites and the test environment

2. Set up claims transformation on trusted forest (Adatum)

3. Set up claims transformation in the trusting forest (Contoso)

4. Validate the scenario

Set up the prerequisites and the test environment

The test configuration involves setting up two forests: Adatum Corporation and Contoso, Ltd, and having a two-way trust between Contoso and Adatum. "adatum.com" is the trusted forest and "contoso.com" is the trusting forest.

The claims transformation scenario demonstrates transformation of a claim in the trusted forest to a claim in the trusting forest. To do this, you need to set up a new forest called adatum.com and populate the forest with a test user with a company value of “Adatum”. You then have to set up a two-way trust between contoso.com and adatum.com.

You need to set up the following for the lab. These procedures are explained in detail in Appendix B: Setting Up the Test Environment

You need to implement the following procedures to set up the lab for this scenario:

1. Set Adatum as trusted forest to Contoso

2. Create the Company claim type on contoso.com

3. Enable the Company resource property on contoso.com

4. Create the central access rule

5. Create the central access policy

6. Publish the new policy through Group Policy

7. Create the Earnings folder on the file server

8. Set classification and apply the central access policy on the Earnings folder 

Use the following information to complete this scenario:

Set up claims transformation on trusted forest (Adatum)

In this step you create a transformation policy in Adatum to deny all claims except “Company” to pass to Contoso.

The Active Directory module for Windows PowerShell provides the DenyAllExcept argument, which drops everything except the specified claims in the transformation policy.

To set up a claims transformation, you need to create a claims transformation policy and link it between the trusted and trusting forests.

Create a claims transformation policy in Adatum

To create a transformation policy Adatum to deny all claims except “Company”

1. Sign in to the domain controller, adatum.com as Administrator with the password pass@word1.

2. Open an elevated command prompt in Windows PowerShell, and type the following:

   New-ADClaimTransformPolicy `
   -Description:"Claims transformation policy to deny all claims except Company"`
   -Name:"DenyAllClaimsExceptCompanyPolicy" `
   -DenyAllExcept:company `
   -Server:"adatum.com" `
   

Set a claims transformation link on Adatum’s trust domain object

In this step, you apply the newly created claims transformation policy on Adatum’s trust domain object for Contoso.

To apply the claims transformation policy

1. Sign in to the domain controller, adatum.com as Administrator with the password pass@word1.

2. Open an elevated command prompt in Windows PowerShell, and type the following:

                       Set-ADClaimTransformLink `
   -Identity:"contoso.com" `
   -Policy:"DenyAllClaimsExceptCompanyPolicy" `
   –TrustRole:Trusted `
   

Set up claims transformation in the trusting forest (Contoso)

In this step you create a claims transformation policy in Contoso (the trusting forest) to deny all claims except “Company.” You need to create a claims transformation policy and link it to the forest trust.

Create a claims transformation policy in Contoso

To create a transformation policy Adatum to deny all except “Company”

1. Sign in to the domain controller, contoso.com as Administrator with the password pass@word1.

2. Open an elevated command prompt in Windows PowerShell and type the following:

   New-ADClaimTransformPolicy `
   -Description:"Claims transformation policy to deny all claims except company" `
   -Name:"DenyAllClaimsExceptCompanyPolicy" `
   -DenyAllExcept:company `
   -Server:"contoso.com" `
   

Set a claims transformation link on Contoso’s trust domain object

In this step, you apply the newly created claims transformation policy on the contoso.com trust domain object for Adatum to allow “Company” be passed through to contoso.com. The trust domain object is named adatum.com.

To set the claims transformation policy

1. Sign in to the domain controller, contoso.com as Administrator with the password pass@word1.

2. Open an elevated command prompt in Windows PowerShell and type the following:

                       Set-ADClaimTransformLink
   -Identity:"adatum.com" `
   -Policy:"DenyAllClaimsExceptCompanyPolicy" `
   –TrustRole:Trusting `
   

Validate the scenario

In this step you try to access the D:\EARNINGS folder that was set up on the file server FILE1 to validate that the user has access to the shared folder.

To ensure that the Adatum user can access the shared folder

1. Sign in to the Client machine, CLIENT1 as Jeff Low with the password pass@word1.

2. Browse to the folder \\FILE1.contoso.com\Earnings.

3. Jeff Low should be able to access the folder.

Additional scenarios for claims transformation policies

Following is a list of additional common cases in claims transformation.

See also

• For a list of all Windows PowerShell cmdlets that are available for claims transformation, see Active Directory PowerShell Cmdlet Reference.

• For advanced tasks that involve export and import of DAC configuration information between two forests, use the Dynamic Access Control PowerShell Reference

• Deploy Claims Across Forests

• Claims Transformation Rules Language

• Dynamic Access Control: Scenario Overview