値が公開された疑いがある場合、またはシークレットが最大登録数に達した場合には、シークレットをローテーションします。
このタスクについて
早期アクセスリリース
既存のシークレットの値を変更することはできません。代わりに新しいシークレットを生成し、まだ登録されていないデバイスを新しいシークレットに移動してから、古いシークレットを非アクティブ化します。
すでに登録済みのデバイスでは、新しいシークレットは必要ありません。まだ事前登録済み(Preregistered)のデバイスのみが影響を受けます。
デバイスは管理コンソール内で移動するか、またはOkta APIを使用して移動できます。
始める前に
- 管理コンソールを使用するには、スーパー管理者またはorg管理者としてサインインします。これらのロールには、デバイスを管理(Manage devices)とデバイス統合を管理(Manage device integrations)の権限があります。「管理者ロール別のデバイス権限」を参照してください。
- このタスクでAPIリクエストを送信するには、スーパー管理者またはorg管理者が作成したAPIトークン、または
okta.deviceIntegrations.manageおよびokta.devices.manageスコープを持つOAuth 2.0アクセストークンを取得します。そのトークンを使用して、APIリクエストを認証します。「Okta APIトークンを管理する」を参照してください。
- 登録されていないデバイスを探します。デバイス(Devices)ページで、事前登録済み(Preregistered)ステータスでフィルタリングします。APIを使用する場合は、各デバイスのシリアル番号とプラットフォームもメモします。
手順
-
新しいシークレットを生成します。「デバイス登録シークレットを作成する」を参照してください。
新しいシークレット値をコピーします。APIを使用する予定の場合、新しいシークレットのIDもメモします。ローテーションが完了するまで、古いシークレットをアクティブのままにします。
-
登録されていないデバイスを新しいシークレットに移動します。
管理コンソールで、新しいシークレットを使用して、もう一度デバイスを事前登録します。モバイルデバイスを事前登録するの手順に従い、これらの変更を行います。
- デバイスを選択(Select devices)手順で、インポート済み(Imported)フィルターを削除し、事前登録済み (Preregistered)ステータスでフィルタリングします。その後、登録されていないデバイスを選択します。
- 秘密鍵を選択(Choose secret key)ステップで、既存の秘密鍵を使用(Use existing secret key)を選択し、新しいシークレットを選択します。
代わりにAPIを使ってデバイスを移動するには、各デバイスのシリアル番号、プラットフォーム、新しいシークレットのIDを指定したPOSTリクエストを/device-identity/api/v1/registration-grantsに送信します。リクエストには、最大1,000個のデバイスを含めることができます。まだ登録待ちのデバイスは、新しいシークレットに移動します。リクエスト内のいずれかのデバイスを更新できない場合は、リクエスト全体が失敗し、Oktaはデバイスを変更しません。応答にはすべてのエラーが一覧表示されるため、修正してリクエストを再送信できます。
[
{
"serialNumber": "DNQJQ4GFF1GH",
"platform": "IOS",
"registrationGrants": [
{
"grantType": "DEVICE_REGISTRATION",
"registrationSecretId": "{newSecretId}"
}
]
}
]
-
モバイルデバイス管理(MDM)ソリューションで、
OktaVerify.DeviceRegistrationSecret値をそれらのデバイスの新しいシークレット値に置き換えます。
-
MDMソリューション内のデバイスを同期し、各デバイスでOkta Verifyが1回実行されることを確認します。
古いシークレットを非アクティブ化する
移動したすべてのデバイスがアクティブ(Active)になったら、古いシークレットを非アクティブ化します。
-
管理コンソールでに移動します。
-
デバイス登録(Device registration)タブを選択します。
-
デバイス登録のシークレット(Secret for device registration)セクションで、古いシークレットのアクション(Actions)メニューを開き、編集(Edit)を選択します。
-
デバイス登録用にこのシークレットを信頼しますか?(Trust this secret for Device Registration?)の今はしない(Not now)を選択します。
信頼できないシークレットを使用してデバイスを登録することはできません。
-
保存(Save)を選択します。
代わりにAPIを使用してシークレットを非アクティブ化するには、PUTリクエストを/device-identity/api/v1/registration-secrets/{oldSecretId}に送信し、statusをINACTIVEに設定します。現在の説明と登録制限を維持します。例では、{existingDescription}と10000をシークレットの既存の値に置き換えます。デバイスを非アクティブなシークレットで登録することはできません。
{
"description": "{existingDescription}",
"status": "INACTIVE",
"maxRegistrations": 10000
}
ヒント:
古いシークレットを削除しないでください。完了した登録を含む、任意のデバイス登録によって参照されるシークレットは、削除できません。代わりにシークレットを非アクティブ化した場合は、後で同じリクエストとACTIVEステータスで再アクティブ化できます。新しい値を作成して配布する必要はありません。
新規で未登録のデバイスは、新しいシークレットで登録されます。古いシークレットは非アクティブで、デバイスを登録できません。