dataStore.provideDataKey( )

4D v18.4


dataStore.provideDataKey ( curPassPhrase \| curDataKey ) -> 戻り値

引数	型	説明
curPassPhrase \| curDataKey	テキスト, オブジェクト	カレントのパスフレーズ(テキスト)またはカレントのデータ暗号化キー(オブジェクト)
戻り値	オブジェクト	暗号化キーのチェックの結果

説明

dataStore.provideDataKey( ) メソッドは、データストアのカレントデータファイルのデータ暗号化キーを受け取り、暗号化されたデータと合致するかどうかチェックします。このコマンドは暗号化されたデータベースを開く時や、例えばデータファイルの再暗号化など暗号化キーが必要となる暗号化オペレーションを実行する際などに使用します。

注:

dataStore.provideDataKey( ) メソッドは暗号化されたデータベース内で呼び出される必要があります。暗号化されていないデータベース内で呼び出された場合、エラー2003 (暗号化キーはデータと合致しません)が返されます。データベースが暗号化されているかどうかを調べるためにはData file encryption status コマンドを使用して下さい。
dataStore.provideDataKey( ) メソッドは、リモートの4D または暗号化されたリモートデータストアから呼び出すことはできません。

引数としては、データベースに合致するcurPassPhrase または curDataKey を渡します:

curPassPhrase: データ暗号化キーを生成するのに使用した文字列(パスフレーズ)。この引数を使用した場合、暗号化キーは無視されます。
curDataKey: (encodedKey プロパティに)データ暗号化キーを格納しているオブジェクト。このキーはNew data key コマンドで生成された可能性がありあます。

有効な暗号化キーが提供された場合、そのキーはメモリ内のkeyChain に追加され、暗号化モードが有効になります:

暗号化可能テーブルでの全てのデータ編集は、ディスク上(.4DD ファイル、ログファイル、. 4Dindx ファイル)では暗号化されます。
暗号化可能テーブルから読み出した全てのデータは、メモリ内では復号化されます。

戻り値

コマンドの実行結果は、詳細な説明を格納したオブジェクトという形で返されます:

プロパティ		型	詳細
success		ブール	提供された暗号化キーが暗号化されたデータと合致すればTrue、それ以外の場合にはFalse

			以下のプロパティは、success プロパティがFALSE であった場合にのみ返されます。
status		数値	エラーコード(提供された暗号化キーが間違っていた場合には4)
statusText		テキスト	エラーメッセージ
errors		コレクション	エラーのスタック。最初のエラーに最も高いインデックスが割り当てられます。
	[ ].componentSignature	テキスト	内部コンポーネント名
	[ ].errCode	Number	エラー番号
	[ ].message	Text	エラーメッセージ

curPassphrase および curDataKey のどちらの引数も渡されなかった場合、dataStore.provideDataKey( ) はnull を返します(この場合エラーは生成されません)。

例題

 C_OBJECT($keyStatus)

 C_TEXT($passphrase)

 

 $passphrase:=Request("Enter the passphrase")

 If(OK=1)

    $keyStatus:=ds.provideDataKey($passphrase)

    If($keyStatus.success)

       ALERT("You have provided a valid encryption key")

    Else

       ALERT("You have provided an invalid encryption key, you will not be able to work with encrypted data")

    End if

 End if

参照

4D Blog - New 4D commands to work with encrypted data
Data file encryption status
Encrypt data file
New data key