### 登録
登録は、第二要素とAuth0アカウント間のリンクです。アカウントが登録されると、本人確認に必要な第二要素を提供するためにアカウントが必要になります。アプリがまだプッシュ通知を使用していない場合、またはプッシュ通知に慣れていない場合、「[Appleプッシュ通知サービスの概要](https://developer.apple.com/go/?id=push-notifications)」を参照してください。
登録には、テナントのドメイン以外に以下の情報が必要です。
| 変数 | 説明 |
|---|---|
| Enrollment URI（登録URI） | Guardian WebウィジェットからスキャンしたQRコード、またはメールかSMS経由で送られてきた登録チケットにエンコードされた値。 |
| APNS Token（APNSトークン） | デバイスのApple APNSトークン。64バイト（16進数形式）を含む文字列で指定する必要があります。 |
| Key Pair（鍵ペア） | Auth0 GuardianでIDをアサ―トするのに使用するRSA（秘密/公開）鍵ペア。 |
#### 署名キーと検証キー
Guardian.swiftは、署名鍵を生成するための便利なクラスを提供しています。
```swift lines theme={null}
let signingKey = try DataRSAPrivateKey.new()
```
このキーはメモリ内にしか存在しません、`データ`表現を取得し、暗号化されたSQLiteDBなどにセキュアに保存できます。
```swift lines theme={null}
// Store data
let data = signingKey.data
// perform the storage
// Load from Storage
let loadedKey = try DataRSAPrivateKey(data: data)
```
しかし、iOSキーチェーンに保存したいだけなら、以下の手順で可能です。
```swift lines theme={null}
let signingKey = try KeychainRSAPrivateKey.new(with: "com.myapp.mytag")
```
上記の例では、キーを作成し、与えられたタグの下に自動的に保存します。それを取得したい場合、タグを使用できます。
```swift lines theme={null}
let signingKey = try KeychainRSAPrivateKey(tag: "com.myapp.mytag")
```
検証キーは、`SigningKey`から取得できます。以下の例を挙げます。
```swift lines theme={null}
let verificationKey = try signingKey.verificationKey()
```
### ログイン要求を許可する
登録を行うと、
### ログイン要求を拒否する
認証要求を拒否するには、代わりに`reject`を呼び出します。オプションで拒否の理由を送ることもできます。拒否の理由はGuardianログに表示されます。
```swift lines theme={null}
Guardian
.authentication(forDomain: "{yourTenantDomain}", device: device)
.reject(notification: notification)
// or reject(notification: notification, withReason: "hacked")
.start { result in
switch result {
case .success:
// the auth request was successfuly rejected
case .failure(let cause):
// something failed, check cause to see what went wrong
}
}
```
### 登録解除する
登録を削除したい場合、たとえばMFAを無効にしたい場合は、以下の要求を行います。
```swift lines theme={null}
Guardian
.api(forDomain: "{yourTenantDomain}")
.device(forEnrollmentId: "{userEnrollmentId}", token: "{enrollmentDeviceToken}")
.delete()
.start { result in
switch result {
case .success:
// success, the enrollment was deleted
case .failure(let cause):
// something failed, check cause to see what went wrong
}
}
```
### モバイル専用OTP登録をセットアップする
#### リソースを接続する
リソースは、Auth0 DashboardまたはGuardian SDKを使って接続できます。
##### Auth0 Dashboardの使用
1. Auth0ログインプロンプトにアクセスし、提供されたコード、または別のソースから取得した同様のbase32エンコードキーをコピーします。次のステップでは、このコードを認証アプリケーションに入力します。
2. コピーしたコードをGuardianなどの認証アプリケーションに追加します。
##### SDKを使用する
1. Guardianライブラリをインポートします。
```swift lines theme={null}
import Guardian
```
2. コードジェネレーターを作成します。
```lines theme={null}
let codeGenerator = try Guardian.totp(
base32Secret: enrollmentCode, // Enrollment code entered by user
algorithm: .sha1 // Algorithm used by TOTP
)
```
3. 生成されたコードを取得します。
```lines theme={null}
codeGenerator.code()
```
#### ワンタイムコードを入力する
Auth0ログインプロンプトで、前のステップで生成したコードを入力します。
［Continue（続ける）］を選択すると、アプリケーションがユーザーの認証要素として追加されたことを示すメッセージが表示されます。
#### アプリでログインする
要素が登録されると、ユーザーはアプリを使用してログインできるようになります。まず、認証方法としてGuardianアプリを選択します。
次に、ワンタイムコードをログインプロンプトに入力し、本人確認を行います。
