ASP.NET Core の目的文字列

IDataProtectionProvider を使うコンポーネントは、CreateProtector メソッドに固有の "目的" パラメーターを渡す必要があります。 目的 "パラメーター" は、データ保護システムのセキュリティに固有のものであり、ルート暗号キーが同じであっても、暗号コンシューマー間の分離を実現できます。

コンシューマーが目的を指定すると、そのコンシューマーに固有の暗号サブキーを派生させるためにルート暗号キーと共に目的文字列が使われます。 これにより、コンシューマーはアプリケーション内の他のすべての暗号コンシューマーから分離されます。そのペイロードは他のコンポーネントから読み取られず、他のコンポーネントのペイロードを読み取ることもできません。 また、この分離により、コンポーネントに対する全カテゴリの攻撃が実行不可能になります。

上の図では、IDataProtector インスタンス A と B は、互いのペイロードを読み取ることができません。自分のペイロードのみを読み取ることができます。

目的文字列はシークレットである必要はありません。 他の適切に動作するコンポーネントが同じ目的文字列を提供することがないという意味で、単に一意である必要があります。

CreateProtector の目的パラメーターは文字列配列なので、上の例は代わりに [ "Contoso.Security.BearerToken", "v1" ] と指定することもできます。 これにより、目的の階層を確立することができます。また、データ保護システムを使ったマルチテナント シナリオの可能性が広がります。

IDataProtectionProvider、IDataProtector、および目的によって提供される分離とその動作は次のとおりです。

• 特定の IDataProtectionProvider オブジェクトに対して CreateProtector メソッドを使うと、それを作成した IDataProtectionProvider オブジェクトと、メソッドに渡された目的パラメーターの両方に一意に関連付けられた IDataProtector オブジェクトが作成されます。

• この目的パラメーターを null にすることはできません (目的が配列として指定されている場合、これは配列の長さをゼロにすることはできず、配列のすべての要素を null 以外にする必要があることを意味します)。空の文字列の目的は技術的には可能ですが、推奨されません。

• 2 つの目的引数が等価になるのは、それらに (序数比較子を使って) 同じ文字列が同じ順序で含まれている場合に限ります。 1 つの目的引数は、対応する単一要素の目的配列と等価です。

• 2 つの IDataProtector オブジェクトが等価になるのは、等価の目的パラメーターを持つ等価の IDataProtectionProvider オブジェクトから作成された場合に限ります。

• 特定の IDataProtector オブジェクトに対して Unprotect(protectedData) を呼び出すと、等価の IDataProtector オブジェクトの protectedData := Protect(unprotectedData) に限り、元の unprotectedData が返されます。