デバイス登録シークレットをローテーションする

値が公開された疑いがある場合、またはシークレットが最大登録数に達した場合には、シークレットをローテーションします。

このタスクについて

早期アクセスリリース

既存のシークレットの値を変更することはできません。代わりに新しいシークレットを生成し、まだ登録されていないデバイスを新しいシークレットに移動してから、古いシークレットを非アクティブ化します。

すでに登録済みのデバイスでは、新しいシークレットは必要ありません。まだ事前登録済み(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を使用する場合は、各デバイスのシリアル番号とプラットフォームもメモします。

手順

  1. 新しいシークレットを生成します。「デバイス登録シークレットを作成する」を参照してください。

    新しいシークレット値をコピーします。APIを使用する予定の場合、新しいシークレットのIDもメモします。ローテーションが完了するまで、古いシークレットをアクティブのままにします。

  2. 登録されていないデバイスを新しいシークレットに移動します。

    管理コンソールで、新しいシークレットを使用して、もう一度デバイスを事前登録します。モバイルデバイスを事前登録するの手順に従い、これらの変更を行います。

    • デバイスを選択(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}"
          }
        ]
      }
    ]
  3. モバイルデバイス管理(MDM)ソリューションで、OktaVerify.DeviceRegistrationSecret値をそれらのデバイスの新しいシークレット値に置き換えます。

    シークレットIDではなく、シークレット値を使用します。「モバイルデバイスでデバイスポスチャセンサーモードをセットアップする」を参照してください。

  4. MDMソリューション内のデバイスを同期し、各デバイスでOkta Verifyが1回実行されることを確認します。
  • 古いシークレットを非アクティブ化する

    移動したすべてのデバイスがアクティブ(Active)になったら、古いシークレットを非アクティブ化します。

    1. 管理コンソールでセキュリティ(Security) > デバイス統合(Device integrations)に移動します。
    2. デバイス登録(Device registration)タブを選択します。
    3. デバイス登録のシークレット(Secret for device registration)セクションで、古いシークレットのアクション(Actions)メニューを開き、編集(Edit)を選択します。
    4. デバイス登録用にこのシークレットを信頼しますか?(Trust this secret for Device Registration?)の今はしない(Not now)を選択します。

      信頼できないシークレットを使用してデバイスを登録することはできません。

    5. 保存(Save)を選択します。

      代わりにAPIを使用してシークレットを非アクティブ化するには、PUTリクエストを/device-identity/api/v1/registration-secrets/{oldSecretId}に送信し、statusをINACTIVEに設定します。現在の説明と登録制限を維持します。例では、{existingDescription}と10000をシークレットの既存の値に置き換えます。デバイスを非アクティブなシークレットで登録することはできません。

      {
        "description": "{existingDescription}",
        "status": "INACTIVE",
        "maxRegistrations": 10000
      }

    新規で未登録のデバイスは、新しいシークレットで登録されます。古いシークレットは非アクティブで、デバイスを登録できません。