Gremlin コンソールでの IAM 認証を使用した Amazon Neptune データベースへの接続

Gremlin コンソールを起動します。

$ bin/gremlin.sh

gremlin> プロンプトで、amazon-neptune-sigv4-signer ライブラリをインストールします (これはコンソールで 1 回だけ行う必要があります)。

:install com.amazonaws amazon-neptune-sigv4-signer 2.4.0

このステップで問題が発生した場合は、Grape 設定に関する TinkerPop ドキュメントを参照すると便利です。

System.setProperty("https.proxyHost", "(the proxy IP address)")
System.setProperty("https.proxyPort", "(the proxy port)")

handshakeInterceptor() へのサインインの処理に必要なクラスをインポートします。

:import com.amazonaws.auth.DefaultAWSCredentialsProviderChain
:import com.amazonaws.neptune.auth.NeptuneNettyHttpSigV4Signer

一時的な認証情報を使用する場合は、以下のようにセッショントークンも指定する必要があります。

System.setProperty("aws.sessionToken","(your session token)")

アカウント認証情報をまだ設定していない場合は、以下のように割り当てることができます。

System.setProperty("aws.accessKeyId","(your access key)")
System.setProperty("aws.secretKey","(your secret key)")

Neptune に接続するように、Cluster オブジェクトを手動で設定します。

cluster = Cluster.build("(host name)")  \
                 .enableSsl(true) \
                 .handshakeInterceptor { r ->  \
                   def sigV4Signer = new NeptuneNettyHttpSigV4Signer("(Amazon region)", \
                                     new DefaultAWSCredentialsProviderChain()); \
                   sigV4Signer.signRequest(r); \
                   return r; } \
                 .create()

Neptune DB インスタンスのホスト名を見つける方法については、「Amazon Neptune エンドポイントに接続する」を参照してください。

前のステップの Cluster オブジェクトの変数名を使用して :remote 接続を確立します。

:remote connect tinkerpop.server cluster

次のコマンドを入力して、リモートモードに切り替えます。これにより、すべての Gremlin クエリがリモート接続に送信されます。

:remote console

Gremlin コンソールを起動します。

$ bin/gremlin.sh

gremlin> プロンプトで、amazon-neptune-sigv4-signer ライブラリをインストールします (これはコンソールで 1 回だけ行う必要があります)。

:install com.amazonaws amazon-neptune-sigv4-signer 2.4.0

System.setProperty("https.proxyHost", "(the proxy IP address)")
System.setProperty("https.proxyPort", "(the proxy port)")

抽出されたディレクトリの conf サブディレクトリに、neptune-remote.yaml という名前のファイルを作成します。

AWS CloudFormation テンプレートを使用して Neptune DB クラスターを作成した場合、 neptune-remote.yaml ファイルは既に存在します。その場合、しなければならないことは、既存のファイルを編集して、以下に示すチャネライザー設定を含めることだけです。

それ以外の場合は、次のテキストを ファイルにコピーし、(host name) を Neptune DB インスタンスのホスト名または IP アドレスに置き換えます。ホスト名を囲む角括弧 ([]) は必須であることに注意してください。

hosts: [(host name)]
port: 8182
connectionPool: {
  channelizer: org.apache.tinkerpop.gremlin.driver.SigV4WebSocketChannelizer,
  enableSsl: true
}
serializer: { className: org.apache.tinkerpop.gremlin.driver.ser.GraphBinaryMessageSerializerV1,
              config: { serializeResultToString: true }}

.yaml ファイルを使用して :remote 接続を確立します。

:remote connect tinkerpop.server conf/neptune-remote.yaml

次のコマンドを入力してリモートモードに切り替え、すべての Gremlin クエリをリモート接続に送信します。

:remote console