認証

Reveal SDK を使用すると、認証プロバイダーを使用し、そのプロバイダーを Reveal SDK に登録することで、ユーザー名 / パスワードおよびベアラートークン認証資格情報などのさまざまな認証方法をデータソースに提供できます。

認証プロバイダーは、認証資格情報を要求しているデータソースを確認し、その特定のデータソースの正しい認証資格情報を返すために使用されます。

手順 1 - 認証プロバイダーを作成します。

ASP.NET
Java
Node.js
Node.js - TS

public class AuthenticationProvider: IRVAuthenticationProvider
{
    public Task<IRVDataSourceCredential> ResolveCredentialsAsync(IRVUserContext userContext, RVDashboardDataSource dataSource)
    {
        ...
    }
}

public class AuthenticationProvider implements IRVAuthenticationProvider {
	@Override
	public IRVDataSourceCredential resolveCredentials(IRVUserContext userContext, RVDashboardDataSource dataSource) {
        ...	
	}
}

const authenticationProvider = async (userContext, dataSource) => {
    ...
}

const authenticationProvider = async (userContext: IRVUserContext | null, dataSource: RVDashboardDataSource) => {
    ...
}

手順 2 - 認証プロバイダーを Reveal SDK に登録します。

ASP.NET
Java
Node.js
Node.js - TS

builder.Services.AddControllers().AddReveal( builder =>
{
    builder.AddAuthenticationProvider<AuthenticationProvider>();
});

RevealEngineInitializer.initialize(new InitializeParameterBuilder().
    setAuthProvider(new AuthenticationProvider()).
    build());

const revealOptions = {
	authenticationProvider: authenticationProvider
};

app.use('/', reveal(revealOptions));

const revealOptions: RevealOptions = {
	authenticationProvider: authenticationProvider
};

app.use('/', reveal(revealOptions));

ユーザー名/パスワード認証

データソースがユーザー名とパスワードの使用を要求する場合、RVUsernamePasswordDataSourceCredential クラスのインスタンスを返す必要があります。RVUsernamePasswordDataSourceCredential クラスは、ユーザー名、パスワード、およびオプションでドメインを定義するコンストラクターのオーバーロードを提供します。

ASP.NET
Java
Node.js
Node.js - TS

public class AuthenticationProvider: IRVAuthenticationProvider
{
    public Task<IRVDataSourceCredential> ResolveCredentialsAsync(IRVUserContext userContext, RVDashboardDataSource dataSource)
    {
        IRVDataSourceCredential userCredential = null;
        if (dataSource is RVPostgresDataSource)
        {
            userCredential = new RVUsernamePasswordDataSourceCredential("username", "password");
        }
        else if (dataSource is RVSqlServerDataSource)
        {
            userCredential = new RVUsernamePasswordDataSourceCredential("username", "password", "domain");
        }
        return Task.FromResult<IRVDataSourceCredential>(userCredential);
    }
}

public class AuthenticationProvider implements IRVAuthenticationProvider {
	@Override
	public IRVDataSourceCredential resolveCredentials(IRVUserContext userContext, RVDashboardDataSource dataSource) {
		if (dataSource instanceof RVPostgresDataSource) {
			return new RVUsernamePasswordDataSourceCredential("username", "password");
		} 
        else if (dataSource instanceof RVSqlServerDataSource) {
			return new RVUsernamePasswordDataSourceCredential("username", "password", "domain");
		} 
		return null;
	}
}

const authenticationProvider = async (userContext, dataSource) => {
	if (dataSource instanceof reveal.RVPostgresDataSource) {
		return new reveal.RVUsernamePasswordDataSourceCredential("username", "password");
	} else if (dataSource instanceof reveal.RVSqlServerDataSource) {
		return new reveal.RVUsernamePasswordDataSourceCredential("username", "password", "domain");
	}
	return null;
}

const authenticationProvider = async (userContext:IRVUserContext | null, dataSource: RVDashboardDataSource) => {
	if (dataSource instanceof RVPostgresDataSource) {
		return new RVUsernamePasswordDataSourceCredential("username", "password");
	} else if (dataSource instanceof RVSqlServerDataSource) {
		return new RVUsernamePasswordDataSourceCredential("username", "password", "domain");
	}
	return null;
}

データソースが認証なしで匿名ログインを使用している場合、空のコンストラクターで RVUsernamePasswordDataSourceCredential を使用できます。

ASP.NET
Java
Node.js
Node.js - TS

if (dataSource is RVSqlServerDataSource)
{
    userCredential = new RVUsernamePasswordDataSourceCredential();
}

if (dataSource instanceof RVSqlServerDataSource) {
    return new RVUsernamePasswordDataSourceCredential();
}

if (dataSource instanceof reveal.RVSqlServerDataSource) {
    return new reveal.RVUsernamePasswordDataSourceCredential();
}

if (dataSource instanceof RVSqlServerDataSource) {
    return new RVUsernamePasswordDataSourceCredential();
}

RVUsernamePasswordDataSourceCredential は、以下のデータソースでサポートされます。

Amazon Redshift
Microsoft Analysis Services サーバー
Microsoft Dynamics CRM (オンプレミスおよびオンライン)
Microsoft SQL Server
MySQL
OData サービス
Oracle
PostgreSQL
REST サービス
Snowflake
Sybase
ウェブリソース

ベアラートークン認証

データソースがセキュリティトークンの使用を要求する場合、RVBearerTokenDataSourceCredential クラスのインスタンスを返す必要があります。RVBearerTokenDataSourceCredential クラスは、トークンとユーザー ID を定義するコンストラクターのオーバーロードを提供します。

ASP.NET
Java
Node.js
Node.js - TS

public class AuthenticationProvider: IRVAuthenticationProvider
{
    public Task<IRVDataSourceCredential> ResolveCredentialsAsync(IRVUserContext userContext, RVDashboardDataSource dataSource)
    {
        IRVDataSourceCredential userCredential = null;
        if (dataSource is RVGoogleDriveDataSource)
        {
            userCredential = new RVBearerTokenDataSourceCredential("token", "userid");
        }
        return Task.FromResult<IRVDataSourceCredential>(userCredential);
    }
}

public class AuthenticationProvider implements IRVAuthenticationProvider {
    @Override
    public IRVDataSourceCredential resolveCredentials(IRVUserContext userContext, RVDashboardDataSource dataSource) {
        if (dataSource instanceof RVGoogleDriveDataSource) {
            return new RVBearerTokenDataSourceCredential("token", "userid");
        }
        return null;
    }
}

const authenticationProvider = async (userContext, dataSource) => {
    if (dataSource instanceof reveal.RVGoogleDriveDataSource) {
        return new reveal.RVBearerTokenDataSourceCredential("token", "userid");
    }
    return null;
}

const authenticationProvider = async (userContext:IRVUserContext | null, dataSource: RVDashboardDataSource) => {
    if (dataSource instanceof RVGoogleDriveDataSource) {
        return new RVBearerTokenDataSourceCredential("token", "userid");
    }
    return null;
}

RVBearerTokenDataSourceCredential は、以下のデータソースでサポートされます。

Box
Databricks
Dropbox
Google アナリティクス
Google Big Query
Google Drive
Microsoft SQL Server
OData サービス
OneDrive
REST サービス
SharePoint オンライン
Snowflake
ウェブリソース

Microsoft Entra ID 認証

Microsoft Entra ID (旧 Azure Active Directory) を使用して、Entra ID 認証をサポートするデータソース (Microsoft SQL Server など) のベアラートークンを取得できます。取得したトークンは、RVBearerTokenDataSourceCredential を使用して Reveal SDK に渡されます。

備考

この例では、.NET 用の Microsoft Authentication Library (MSAL) を使用しています。この方法を使用する前に、Microsoft Entra ID でアプリケーションを登録し、適切なデータベース権限を付与する必要があります。

手順 1 - Microsoft.Identity.Client NuGet パッケージをインストールします。

dotnet add package Microsoft.Identity.Client

手順 2 - Entra ID からトークンを取得し、RVBearerTokenDataSourceCredential として返す認証プロバイダーを作成します。

ASP.NET

public class AuthenticationProvider : IRVAuthenticationProvider
{
    public async Task<IRVDataSourceCredential> ResolveCredentialsAsync(IRVUserContext userContext,
        RVDashboardDataSource dataSource)
    {
        if (dataSource is RVSqlServerDataSource)
        {
            var token = await GetEntraTokenAsync("https://database.windows.net/.default");
            return new RVBearerTokenDataSourceCredential(token, "myaccount@mydomain.com");
        }

        return new RVUsernamePasswordDataSourceCredential();
    }

    private static readonly string ClientId = "your-client-id";
    private static readonly string ClientSecret = "your-client-secret";
    private static readonly string TenantId = "your-tenant-id";

    private static async Task<string> GetEntraTokenAsync(string scope)
    {
        var app = ConfidentialClientApplicationBuilder
            .Create(ClientId)
            .WithClientSecret(ClientSecret)
            .WithAuthority(AzureCloudInstance.AzurePublic, TenantId)
            .Build();

        var result = await app
            .AcquireTokenForClient(new[] { scope })
            .ExecuteAsync();

        return result.AccessToken;
    }
}

注記

your-client-id、your-client-secret、your-tenant-id を Entra ID アプリ登録の値に置き換えてください。スコープ値 https://database.windows.net/.default は Azure SQL Server に固有です。他のデータソースでは異なるスコープが必要になる場合があります。

Microsoft Entra ID 認証は、以下のデータソースでサポートされます。

Microsoft SQL Server

キーペア認証

データソースがキーペア認証を必要とする場合、RVKeyPairDataSourceCredential クラスのインスタンスを返す必要があります。RVKeyPairDataSourceCredential クラスは、ユーザーと暗号化されていない RSA 秘密キーを定義するコンストラクターのオーバーロードを提供します。

ASP.NET
Java
Node.js
Node.js - TS

public class AuthenticationProvider: IRVAuthenticationProvider
{
    public Task<IRVDataSourceCredential> ResolveCredentialsAsync(IRVUserContext userContext, RVDashboardDataSource dataSource)
    {
        IRVDataSourceCredential userCredential = null;
        if (dataSource is RVSnowflakeDataSource)
        {
            userCredential = new RVKeyPairDataSourceCredential("user", "unencrypted rsa-key");
        }
        return Task.FromResult<IRVDataSourceCredential>(userCredential);
    }
}

public class AuthenticationProvider implements IRVAuthenticationProvider {
    @Override
    public IRVDataSourceCredential resolveCredentials(IRVUserContext userContext, RVDashboardDataSource dataSource) {
        if (dataSource instanceof RVSnowflakeDataSource) {
            return new RVKeyPairDataSourceCredential("user", "unencrypted rsa-key");
        }
        return null;
    }
}

const authenticationProvider = async (userContext, dataSource) => {
    if (dataSource instanceof reveal.RVSnowflakeDataSource) {
        return new reveal.RVKeyPairDataSourceCredential("user", "unencrypted rsa-key");
    }
    return null;
}

const authenticationProvider = async (userContext:IRVUserContext | null, dataSource: RVDashboardDataSource) => {
    if (dataSource instanceof RVSnowflakeDataSource) {
        return new RVKeyPairDataSourceCredential("user", "unencrypted rsa-key");
    }
    return null;
}

RVKeyPairDataSourceCredential は、以下のデータソースでサポートされます。

Snowflake

Amazon Web Services

データソースが Amazon Web Services (AWS) を使用している場合は、RVAmazonWebServicesCredentials クラスのインスタンスを返す必要があります。RVAmazonWebServicesCredentials クラスは、key と secret を定義するためのコンストラクターのオーバーロードを提供します。

ASP.NET
Java
Node.js
Node.js - TS

public class AuthenticationProvider: IRVAuthenticationProvider
{
    public Task<IRVDataSourceCredential> ResolveCredentialsAsync(IRVUserContext userContext, RVDashboardDataSource dataSource)
    {
        IRVDataSourceCredential userCredential = null;
        if (dataSource is RVS3DataSource)
        {
            userCredential = new RVAmazonWebServicesCredentials("key", "secret");
        }
        return Task.FromResult<IRVDataSourceCredential>(userCredential);
    }
}

public class AuthenticationProvider implements IRVAuthenticationProvider {
    @Override
    public IRVDataSourceCredential resolveCredentials(IRVUserContext userContext, RVDashboardDataSource dataSource) {
        if (dataSource instanceof RVS3DataSource) {
            return new RVAmazonWebServicesCredentials("key", "secret");
        }
        return null;
    }
}

const authenticationProvider = async (userContext, dataSource) => {
    if (dataSource instanceof reveal.RVS3DataSource) {
        return new reveal.RVAmazonWebServicesCredentials("key", "secret");
    }
    return null;
}

const authenticationProvider = async (userContext:IRVUserContext | null, dataSource: RVDashboardDataSource) => {
    if (dataSource instanceof RVS3DataSource) {
        return new RVAmazonWebServicesCredentials("key", "secret");
    }
    return null;
}

RVAmazonWebServicesCredentials は、次のデータソースでサポートされています。

Amazon Athena
Amazon S3

ユーザー名/パスワード認証​

ベアラー トークン認証​

Microsoft Entra ID 認証​

キーペア認証​

Amazon Web Services​

ユーザー名/パスワード認証

ベアラートークン認証

Microsoft Entra ID 認証

キーペア認証

Amazon Web Services