Amazon Verified Permissions から Cedar 4 へのアップグレードに関するよくある質問 - Amazon Verified Permissions
一部のポリシー、ポリシーテンプレート、スキーマが Cedar 4 と互換性がないのはなぜですか？ ポリシーストアで Cedar 2 と Cedar 4 のどちらを使用しているかを確認するにはどうすればよいですか？ Cedar 4 にアップグレードするにはどうすればよいですか？ ポリシーストアを Cedar 4 から Cedar 2 にダウングレードできますか？ ポリシーストアが Cedar 2 に設定されているというエラーメッセージが表示されるのはなぜですか？ スキーマを Cedar 4 と互換性を持たせるにはどうすればよいですか？

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon Verified Permissions から Cedar 4 へのアップグレードに関するよくある質問

Amazon Verified Permissions は、使用する Cedar のバージョンをバージョン 2 からバージョン 4 にアップグレードしています。Cedar は、ポリシーストアでポリシー、ポリシーテンプレート、スキーマを記述するために使用するオープンソース言語です。Verified Permissions での Cedar 4 のサポートにより、is演算子タグやエンティティタグなどの新機能を使用して、より表現力の高いポリシーを記述できます。

Amazon Verified Permissions は、ポリシーストアを Cedar 4 に自動的にアップグレードします。ただし、Cedar 2 用に記述された一部のポリシー、スキーマ、認可リクエストは、Cedar 4 と互換性がありません。ポリシーストアの場合は、自動的にアップグレードされません。Cedar 4 にアップグレードする前に、ポリシー、ポリシーテンプレート、スキーマ、またはアプリケーションコードを変更する必要がある場合があります。

一部のポリシー、ポリシーテンプレート、スキーマが Cedar 4 と互換性がないのはなぜですか？

Cedar チームは、バグを修正し、言語を簡素化するために、Cedar 2 以降、下位互換性のないいくつかの変更を行いました。これらの変更には次の場合が含まれます。

  • ポリシー、ポリシーテンプレート、スキーマの構文変更

  • より多くのエラーを検出する、より正確なポリシー検証ツール

  • などの組み込み関数の動作の変更 isInRange

下位互換性のない変更の完全なリストについては、Cedar 変更ログ(*)で とマークされた項目を探します。

ポリシーストアで Cedar 2 と Cedar 4 のどちらを使用しているかを確認するにはどうすればよいですか？

ポリシーストアが使用する Cedar のバージョンは、Amazon Verified Permissions コンソールまたは GetPolicyStoreオペレーションを使用して確認できます。

注記

同じ AWS アカウント およびリージョンのすべてのポリシーストアは、同じバージョンの Cedar を使用します。

Console
Cedar バージョンのポリシーストアを確認するには (コンソール）

  1. にサインイン AWS Management Console し、https://console.aws.amazon.com/verifiedpermissions/ で Amazon Verified Permissions コンソールを開きます。

  2. ナビゲーションペインから、ポリシーストアを選択し、確認するポリシーストアを選択します。

  3. ナビゲーションペインで [設定] を選択します。

  4. 詳細ボックスで、Cedar バージョンフィールドを見つけます。

フィールドは、ポリシーストアが Cedar 2 を使用している場合と、Cedar 4 CEDAR_4を使用している場合に読み取りCEDAR_2ます。

CLI
Cedar バージョンのポリシーストアを確認するには (AWS CLI）

  1. まだインストールしていない場合は、 AWS Command Line Interface （AWS CLI) をインストールして設定します。詳細については、「AWS CLIの最新バージョンをインストールまたは更新します。」を参照してください。

  2. get-policy-store コマンドを使用します。次の例では、policy-store-id をポリシーストアの識別子に置き換えます。

    aws verifiedpermissions get-policy-store \
  --policy-store-id policy-store-id

出力の cedarVersionフィールドには、ポリシーストアが使用している Cedar のバージョンが表示されます。例: 

{
    "policyStoreId": "ABCDEFG12345678abcdefg",
    "arn": "arn:aws:verifiedpermissions::111122223333:policy-store/ABCDEFG12345678abcdefg",
    "validationSettings": {
        "mode": "STRICT"
    },
    "createdDate": "2025-06-03T13:09:47.752255+00:00",
    "lastUpdatedDate": "2025-06-03T13:09:47.752255+00:00",
    "deletionProtection": "ENABLED",
    "cedarVersion": "CEDAR_2"
}

フィールドは、ポリシーストアが Cedar 2 を使用している場合と、Cedar 4 CEDAR_4を使用している場合に読み取りCEDAR_2ます。

Cedar 4 にアップグレードするにはどうすればよいですか？

Amazon Verified Permissions では、ほとんどのお客様が Cedar 4 にアップグレードされています。ポリシーストアを作成したことがない場合、作成した新しいポリシーストアは Cedar 4 を使用します。既存のお客様は、Cedar 4 にアップグレード済みである可能性があります。ポリシーストアが使用している Cedar のバージョンを確認するには ポリシーストアで Cedar 2 と Cedar 4 のどちらを使用しているかを確認するにはどうすればよいですか？ 、「」を参照してください。

アップグレードされていない場合、Verified Permissions は、Cedar 4 と互換性のないポリシーストアの 1 つでポリシー、ポリシーテンプレート、スキーマ、または認可リクエストを検出しました。2025 年後半に、互換性のないリソースについて説明する E メール通知が送信されます。より早くアップグレードするには、 でケースを開きます サポート。

重要

同じ のすべてのポリシーストアは、同じバージョンの Cedar AWS アカウント を使用します。アカウント内の 1 つのポリシーストアが Cedar 4 と互換性がない場合、そのアカウントのどのポリシーストアでも Cedar 4 を使用することはできません。

ポリシーストアを Cedar 4 から Cedar 2 にダウングレードできますか？

いいえ。ポリシーストアを Cedar 4 にアップグレードした後に問題が発生した場合は、 でケースを開きます サポート。

ポリシーストアが Cedar 2 に設定されているというエラーメッセージが表示されるのはなぜですか？

Amazon Verified Permissions の一部の機能は、Cedar 4 の新機能に依存しています。ポリシーストアで Cedar 4 が使用されていない場合、次の API フィールドは使用できません。

  • IsAuthorized、BatchIsAuthorized、IsAuthorizedWithTokenおよび BatchIsAuthorizedWithTokenオペレーションの場合：

    • datetime、、decimalまたは contextフィールドの duration attributes値

ポリシーストアがアップグレードされるまで、Cedar 2 の後に導入されたポリシー、ポリシーテンプレート、スキーマで構文またはデータ型を使用することはできません。

スキーマを Cedar 4 と互換性を持たせるにはどうすればよいですか？

Verified Permissions コンソールのコードエディタを使用して、Cedar 4 でスキーマの使用を停止しているエラーを確認できます。

重要

Amazon Verified Permissions コンソールのコードエディタには、ポリシーストアで Cedar 2 を使用している場合でも、常に Cedar 4 のエラーと警告が表示されます。変更の保存ボタンまたは Verified Permissions API を使用して、Cedar 4 と互換性のないスキーマを引き続き更新できます。

コンソールでスキーマのエラーを表示するには

  1. にサインイン AWS Management Console し、検証済みのアクセス許可で Amazon Verified Permissions コンソールを開きます。

  2. ナビゲーションペインから、ポリシーストアを選択し、確認するポリシーストアを選択します。

  3. ナビゲーションペインでスキーマを選択します。

  4. [Edit schema] を選択します。

  5. JSON モードを選択します。

  6. コードエディタの左側にあるガーターの赤いエラーアイコンにカーソルを合わせます。エラーメッセージがツールヒントに表示されます。

発生する可能性のある一般的なエラーとその解決方法は次のとおりです。

が JSON からスキーマを解析できませんでした: `field-name`

Cedar 2 では、Cedar スキーマの一部として意味がない場合でも、型定義などのスキーマの一部に任意のフィールドを含めることができます。Cedar 4 では、これは許可されなくなりました。このエラーを解決するには、JSON スキーマから field-name というフィールドを削除します。有効なスキーマフィールドのリストについては、Cedar のドキュメントを参照してください。

不明な拡張タイプ `extension-name`

Cedar 2 では、 typeが である属性を宣言するときにExtension、値が有効な拡張タイプ名であるかどうかにかかわらず、 nameフィールドに任意の値を指定できます。これは Cedar 4 のエラーになりました。これを解決するには、extension-name を有効な拡張タイプ名に置き換えます。有効な拡張タイプ名のリストは、Cedar ドキュメントで確認できます。