# Blackbaud Raiser's Edge NXT 接続の設定
<a name="blackbaud-configuring-connections"></a>

Blackbaud Raiser's Edge NXT は、OAuth2 の AUTHORIZATION\$1CODE グラントタイプをサポートしています。
+ このグラントタイプは、ユーザーを認証するためにサードパーティーの認証サーバーにユーザーをリダイレクトすることから、「three-legged」の OAuth と見なされます。AWS Glue コンソール経由で接続を作成するときに使用されます。AWS Glue コンソールでは、ユーザーが Blackbaud Raiser's Edge NXT にリダイレクトされます。ここではユーザーがログインし、Blackbaud Raiser's Edge NXT インスタンスにアクセスするためのリクエストされたアクセス許可を AWS Glue に許可する必要があります。
+ ユーザーは、Blackbaud Raiser's Edge NXT で独自の接続アプリを作成し、AWS Glue コンソールを介して接続を作成するときに独自のクライアント ID、サブスクリプションキー、およびインスタンス URL を指定することを選択できます。このシナリオでは、引き続き Blackbaud Raiser's Edge NXT にリダイレクトされてログインし、リソースへアクセスするために AWS Glue を承認します。
+ このグラントタイプは、更新トークンとアクセストークンになります。アクセストークンの有効期間は短く、更新トークンを使用してユーザーとやり取りすることなく自動的に更新される場合があります。
+ 認可コード OAuth フロー用の接続アプリの作成に関する Blackbaud Raiser's Edge NXT の公開ドキュメントについては、「[Authorization](https://developer.blackbaud.com/skyapi/docs/authorization)」を参照してください。

Blackbaud Raiser's Edge NXT 接続を設定するには:

1. AWS Secrets Manager で、次の詳細を含むシークレットを作成します。

   1. カスタマーマネージド接続アプリケーションの場合、シークレットには、`USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` を使用して接続されたアプリケーションの API キーをキーとして含める必要があります。

   1. 注: AWS Glue で接続にシークレットを作成する必要があります。

1. AWS Glue Glue Studio で、以下の手順に従って **[データ接続]** の下に接続を作成します。

   1. **[データソース]** を選択する際に、[Blackbaud Raiser's Edge NXT] を選択します。

   1. 接続する Blackbaud Raiser's Edge NXT アカウントの `INSTANCE_URL` を指定します。

   1. ユーザーマネージドクライアントアプリケーション `clientId` を指定します。

   1. アカウントに関連付けられたサブスクリプションキーを指定します。

   1. 次のアクションを実行でき、AWS Glue がその権限を持つ AWS IAM ロールを選択します。

------
#### [ JSON ]

****  

      ```
      {
        "Version":"2012-10-17",		 	 	 
        "Statement": [
          {
            "Effect": "Allow",
            "Action": [
              "secretsmanager:DescribeSecret",
              "secretsmanager:GetSecretValue",
              "secretsmanager:PutSecretValue",
              "ec2:CreateNetworkInterface",
              "ec2:DescribeNetworkInterfaces",
              "ec2:DeleteNetworkInterface"
            ],
            "Resource": "*"
          }
        ]
      }
      ```

------

   1. AWS Glue でこの接続に使用する `secretName` を選択して、トークンを配置します。

   1. ネットワークを使用する場合は、ネットワークオプションを選択します。

1. AWS Glue ジョブに関連付けられている IAM ロールに `secretName` を読み取るアクセス許可を付与します。