# Amazon Resilience Hub and Amazon Organizations
<a name="services-that-can-integrate-resilience-hub"></a>

Amazon Resilience Hub helps you define, validate, and track the resilience of your applications so that you can avoid unnecessary downtime caused by software, infrastructure, or operational disruptions.

When you integrate Resilience Hub with Amazon Organizations, the management account enables trusted access and designates a delegated administrator account. With the delegated administrator account, you get organization-wide visibility into resilience posture and aggregated dashboards across member accounts.

For more information, see [Amazon Organizations integration](https://docs.amazonaws.cn/resilience-hub/latest/userguide/next-gen-organizations.html) in the *Amazon Resilience Hub User Guide*.

Use the following information to help you integrate Amazon Resilience Hub with Amazon Organizations.



## Service-linked roles created when you enable integration
<a name="integrate-enable-slr-resilience-hub"></a>

The following [service-linked role](https://docs.amazonaws.cn/IAM/latest/UserGuide/using-service-linked-roles.html) is automatically created in your organization's management account when you enable trusted access. This role allows Resilience Hub to perform supported operations within your organization's accounts in your organization.

You can delete or modify this role only if you disable trusted access between Resilience Hub and Organizations, or if you remove the member account from the organization.

For more information about how Resilience Hub uses this role, see [Service-Linked Roles](https://docs.amazonaws.cn/resilience-hub/latest/userguide/next-gen-org-slrs.html) in the *Amazon Resilience Hub User Guide*.
+ `AWSServiceRoleForResilienceHub`

## Service principals used by the service-linked roles
<a name="integrate-enable-svcprin-resilience-hub"></a>

The service-linked role in the previous section can be assumed only by the service principals authorized by the trust relationships defined for the role. The service-linked roles used by Resilience Hub grant access to the following service principals:
+ `resiliencehub.amazonaws.com`

## To enable trusted access with Amazon Resilience Hub
<a name="integrate-enable-ta-resilience-hub"></a>

For information about the permissions needed to enable trusted access, see [Permissions required to enable trusted access](orgs_integrate_services.md#orgs_trusted_access_perms).

Resilience Hub requires trusted access to Amazon Organizations before you can designate a member account to be the delegated administrator for your organization.

You can only enable trusted access using Amazon Resilience Hub.

**To enable trusted access using the Resilience Hub console**  
For instructions on enabling trusted access, see [Setting up Amazon Organizations integration](https://docs.amazonaws.cn/resilience-hub/latest/userguide/next-gen-delegated-admin-setup.html) in the *Amazon Resilience Hub User Guide*.

You can enable trusted access by running a Organizations Amazon CLI command, or by calling an Organizations API operation in one of the Amazon SDKs.

------
#### [ Amazon CLI, Amazon API ]

**To enable trusted service access using the Organizations CLI/SDK**  
Use the following Amazon CLI commands or API operations to enable trusted service access:
+ Amazon CLI: [enable-aws-service-access](https://docs.amazonaws.cn/cli/latest/reference/organizations/enable-aws-service-access.html)

  Run the following command to enable Amazon Resilience Hub as a trusted service with Organizations.

  ```
  $ aws organizations enable-aws-service-access \
      --service-principal resiliencehub.amazonaws.com
  ```

  This command produces no output when successful.
+ Amazon API: [EnableAWSServiceAccess](https://docs.amazonaws.cn/organizations/latest/APIReference/API_EnableAWSServiceAccess.html)

------

## To disable trusted access with Resilience Hub
<a name="integrate-disable-ta-resilience-hub"></a>

For information about the permissions needed to disable trusted access, see [Permissions required to disable trusted access](orgs_integrate_services.md#orgs_trusted_access_disable_perms).

Only an administrator in the Amazon Organizations management account can disable trusted access with Amazon Resilience Hub.

You can only disable trusted access using the Organizations tools.

You can disable trusted access by running a Organizations Amazon CLI command, or by calling an Organizations API operation in one of the Amazon SDKs.

------
#### [ Amazon CLI, Amazon API ]

**To disable trusted service access using the Organizations CLI/SDK**  
Use the following Amazon CLI commands or API operations to disable trusted service access:
+ Amazon CLI: [disable-aws-service-access](https://docs.amazonaws.cn/cli/latest/reference/organizations/disable-aws-service-access.html)

  Run the following command to disable Amazon Resilience Hub as a trusted service with Organizations.

  ```
  $ aws organizations disable-aws-service-access \
      --service-principal resiliencehub.amazonaws.com
  ```

  This command produces no output when successful.
+ Amazon API: [DisableAWSServiceAccess](https://docs.amazonaws.cn/organizations/latest/APIReference/API_DisableAWSServiceAccess.html)

------

## To enable a delegated administrator account for Resilience Hub
<a name="integrate-enable-da-resilience-hub"></a>

With the delegated administrator account, you get organization-wide visibility into resilience posture and aggregated dashboards across member accounts without signing in to individual accounts.

**Minimum permissions**  
Only a user or role in the Organizations management account with the following permissions can configure a member account as a delegated administrator for Resilience Hub in the organization:  
`organizations:RegisterDelegatedAdministrator`
`organizations:EnableAWSServiceAccess`

For instructions on enabling a delegated administrator account for Resilience Hub, see [Setting up Amazon Organizations integration](https://docs.amazonaws.cn/resilience-hub/latest/userguide/next-gen-delegated-admin-setup.html) in the *Amazon Resilience Hub User Guide*.

------
#### [ Amazon CLI, Amazon API ]

To configure a delegated administrator account using the Amazon CLI or one of the Amazon SDKs, use the following commands:
+ Amazon CLI: 

  ```
  $ aws organizations register-delegated-administrator \
      --account-id 123456789012 \
      --service-principal resiliencehub.amazonaws.com
  ```
+ Amazon SDK: To register the delegated administrator, call the Organizations `RegisterDelegatedAdministrator` operation. Provide the member account's ID and the service principal `resiliencehub.amazonaws.com` as parameters. 

------

## To disable a delegated administrator for Resilience Hub
<a name="integrate-disable-da-resilience-hub"></a>

Only an administrator in the Organizations management account can remove a delegated administrator for Resilience Hub. You can disable the delegated administrator using the Organizations `DeregisterDelegatedAdministrator` CLI or SDK operation.

------
#### [ Amazon CLI, Amazon API ]

To remove a delegated administrator account using the Amazon CLI or one of the Amazon SDKs, use the following commands:
+ Amazon CLI: 

  ```
  $ aws organizations deregister-delegated-administrator \
      --account-id 123456789012 \
      --service-principal resiliencehub.amazonaws.com
  ```
+ Amazon SDK: To remove the delegated administrator, call the Organizations `DeregisterDelegatedAdministrator` operation. Provide the member account's ID and the service principal `resiliencehub.amazonaws.com` as parameters. 

------