S-JIS[2023-10-22/2025-09-25]

Tsubakuro/Java Credential

TsurugiのTsubakuro/Java（Java通信ライブラリー）のCredentialクラスのメモ。

概要

Tsubakuro/JavaのCredentialは、Tsurugiサーバーに接続する際の認証情報を表すクラス。
CredentialはSessionを生成する際にSessionBuilderのwithCredentialメソッドで指定する。

import com.tsurugidb.tsubakuro.channel.common.connection.Credential;

    Credential credential = 〜;
    try (Session session = SessionBuilder.connect(endpoint).withCredential(credential).create(3, TimeUnit.SECONDS)) {
        〜
    }

Credentialの具象クラス（認証方法）は何種類かある。
しかし現時点ではTsurugiサーバーには認証が実装されていないので、何を指定しても接続できる。
したがって現時点ではNullCredentialを使っておけばいい。（SessionBuilderのデフォルトはNullCredential）

Tsurugi 1.6.0で試験的機能としてユーザー認証が実装された。[2025-09-25]
ただしデフォルトではユーザー認証は無効なので、従来通りの方法で良い。

NullCredential

NullCredentialは認証無しを表すCredentialクラス。

import com.tsurugidb.tsubakuro.channel.common.connection.NullCredential;

public static Credential nullCredential() {
    return NullCredential.INSTANCE;
}

UsernamePasswordCredential

UsernamePasswordCredentialはユーザー名とパスワードを使用するCredentialクラス。

import com.tsurugidb.tsubakuro.channel.common.connection.UsernamePasswordCredential;

public static Credential userPasswordCredential() {
    return new UsernamePasswordCredential("name", "password");
}

→Tsurugi 1.6.0でユーザー・パスワードを定義する方法

RememberMeCredential

RememberMeCredentialは認証トークンを使用するCredentialクラス。

import com.tsurugidb.tsubakuro.channel.common.connection.RememberMeCredential;

public static Credential rememberMeCredential(String authenticatedToken) {
    return new RememberMeCredential(authenticatedToken);
}

→Tsurugi 1.6.0の認証トークンの作成方法

FileCredential

FileCredentialは認証情報ファイルを使用するCredentialクラス。

import com.tsurugidb.tsubakuro.channel.common.connection.FileCredential;

public static Credential fileCredential(Path file) throws IOException {
    return FileCredential.load(file);
}

→Tsurugi 1.6.0の認証ファイルの作成方法