> ## Documentation Index
> Fetch the complete documentation index at: https://namespace.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# nsc auth trust-aws-cognito-identity-pool

Trust an AWS Cognito identity pool.

`nsc auth trust-aws-cognito-identity-pool` establishes trust between your Namespace workspace and an AWS Cognito identity pool, so that identities issued by that pool can be exchanged for Namespace access. It is a narrower, Cognito-specific counterpart to [`nsc auth trust-relationships add`](/docs/reference/cli/auth-trust-relationships-add) — rather than specifying a generic OIDC issuer and subject-match pattern yourself, you point this command at the identity pool and it configures the trust relationship for you.

Once a pool is trusted, tokens obtained from it can be redeemed for a Namespace token using `nsc auth exchange-aws-cognito-token`.

## Usage

```bash theme={null}
nsc auth trust-aws-cognito-identity-pool [--aws_region string] [--identity_pool string] [--tenant_id string]
```

### Example

```bash theme={null}
nsc auth trust-aws-cognito-identity-pool \
  --identity_pool "us-east-1:11111111-2222-3333-4444-555555555555" \
  --aws_region us-east-1
```

## Options

<h3 id="--aws_region-string">
  \--aws\_region string
</h3>

The AWS region to connect to. This should match the region the Cognito identity pool was created in.

<h3 id="--identity_pool-string">
  \--identity\_pool string
</h3>

UUID of the identity pool to trust. This identifies the specific AWS Cognito identity pool whose identities will be accepted.

<h3 id="--tenant_id-string">
  \--tenant\_id string
</h3>

What tenant to authenticate. Use this to target a specific tenant when your account has access to more than one.

## Related Topics

* [nsc auth trust-relationships](/docs/reference/cli/auth-trust-relationships) - Manage general-purpose OIDC trust relationships
* [nsc auth trust-relationships add](/docs/reference/cli/auth-trust-relationships-add) - Add a trust relationship with a custom issuer and subject match pattern