OpenWithNewToken(char[])

このメソッドは、トークン・リフレッシュ・コール・バックを使用するかわりに、リフレッシュ/更新されたアクセス・トークンをODP.NETに直接提供することで新しい接続を開くために使用できます。アプリケーションが、リフレッシュ/更新されたアクセス・トークンをトークン・リフレッシュ・コール・バックを介して提供できない場合にのみ使用することをお薦めします。

宣言

// C#
public void OpenWithNewToken(char[] token)

例外

  • トークンがnullとして渡されると、ArgumentNullExceptionが発生します。

  • InvalidOperationException - 接続がすでに開かれているか、接続にOracleAccessTokenオブジェクトが設定されていません。

  • OracleException - トークン認証の場合、エラーには「ORA-25707: トークンが無効です。」および「ORA-25708: トークンが期限切れです」が含まれます。

説明

ODP.NETは、提供されたアクセス・トークンを使用して新しいデータベース接続を開きます。新しい接続が正常に開かれると、基礎となるOracleAccessTokenオブジェクトが新しいアクセス・トークンで更新されます。ドライバが新しい接続を開くことに失敗した場合、例外がスローされ、アクセス・トークンは無視されます。

アクセス・トークンに渡されたchar[]は、セキュリティ上の理由でODP.NETをクリアします。アプリケーションは、このメソッドが呼び出されたらchar[]に依存しないようにしてください。

アクセス・トークンのクライアント側検証の場合:

  • アクセス・トークンは16KBバイト以下である必要があります。

  • ピリオド"."が2つ必要です。

  • 有効なベース64である必要があります。

  • 有効なJSONである必要があります

  • "sub"および"exp"クレームが必要です。