Hologres RAM角色授权模式

管控台登录和HoloWeb登录

当您完成授权之后，使用者就可以扮演user-role角色登录并使用Hologres。

1. 使用RAM角色，登录Hologres管理控制台，对Hologres实例进行管控。

2. 在Hologres控制台页面，单击左侧导航栏前往HoloWeb，进入HoloWeb页面，进行Hologres结构设计和数据开发。具体操作请参见连接HoloWeb并执行查询。

JDBC和PSQL客户端登录

从Hologres V2.0版本开始，Hologres支持在PostgreSQL协议的连接选项中指定Security Token。您可以凭借Security Token，通过PostgreSQL客户端，如JDBC或PSQL，实现RAM角色登录访问Hologres。

在访问Hologres之前，您需要先确认已完成下述两项操作：

• 您已添加RAM角色至Hologres实例并授权。详情请参见步骤二：添加RAM角色至Hologres实例并授权。

• 您已调用访问控制中的API（AssumeRole - 获取扮演角色的临时身份凭证）获取STS Token三元组（AccessKeyId、AccessKeySecret和SecurityToken）。具体操作步骤，详情请参见STS SDK调用示例。STS Token示例信息如下：

  "Credentials": {
      "SecurityToken": "CAISuwJ1q6Ft5B2yu****KiAA",
      "AccessKeyId": "STS.NTKaenSkmLhG4HpM5****76UV",
      "AccessKeySecret": "6itECZnhbG2RU6ktTSBSd6JxeLHKPWyBt****SS62",
      "Expiration": "2025-02-21T03:47:07Z"
    }

确认完成操作后，您可以通过以下方式连接并使用Hologres。

• JDBC JAVA连接方式：更多操作信息，详情请参见JDBC连接Hologres。

  • 示例代码1：通过PostgreSQL JDBC Driver自带的PGProperty类的属性来加载STS Token三元组完成身份校验。

    import org.postgresql.PGProperty;
    import java.sql.*;
    import java.io.IOException;
    import java.util.Properties;
    
    public class JdbcLinkHologres1 {
        public static void main(String[] args) throws IOException, ClassNotFoundException, SQLException {
             // 此处以把AccessKey和AccessKeySecret保存在环境变量为例说明。您也可以根据业务需要，保存到配置文件里
    	// 强烈建议不要把AccessKey和AccessKeySecret保存到代码里，会存在密钥泄漏风险
            String accessKeyId = "ALIBABA_CLOUD_ACCESS_KEY_ID";
            String accessKeySecret = "ALIBABA_CLOUD_ACCESS_KEY_SECRET";
            String securityToken = "<SecurityToken>";
            String url = "jdbc:postgresql://<host>:<port>/<database>";
    
            Properties props = new Properties();
            PGProperty.USER.set(props, accessKeyId);
            PGProperty.PASSWORD.set(props, accessKeySecret);
            PGProperty.OPTIONS.set(props, "sts_token=" + securityToken);
    
            Class.forName("org.postgresql.Driver");
            Connection connection = DriverManager.getConnection(url, props);
    
            Statement statement = connection.createStatement();
            ResultSet resultSet = statement.executeQuery("SELECT * FROM tabletest");
            // Process the resultSet
            while (resultSet.next()) {
                System.out.println("Result: " + resultSet.getInt(1));
                System.out.println("Result: " +  resultSet.getString(2));
            }
        }
    }

  • 示例代码2：通过先对SecurityToken信息进行URL编码然后拼接至JDBC的URL中，再通过驱动类获取Hologres链接时加载AccessKeyId和AccessKeySecret进行身份验证。

    import java.net.URLEncoder;
    import java.sql.*;
    import java.io.IOException;
    
    public class JdbcLinkHologres2 {
        public static void main(String[] args) throws IOException, ClassNotFoundException, SQLException {
            // 此处以把AccessKey和AccessKeySecret保存在环境变量为例说明。您也可以根据业务需要，保存到配置文件里
    	// 强烈建议不要把AccessKey和AccessKeySecret保存到代码里，会存在密钥泄漏风险
            String accessKeyId = "ALIBABA_CLOUD_ACCESS_KEY_ID";
            String accessKeySecret = "ALIBABA_CLOUD_ACCESS_KEY_SECRET";
            String securityToken = "<SecurityToken>";
                        
            String url = "jdbc:postgresql://<host>:<port>/<database>";
            String urlWithOptions = url + "?options=sts_token=" + URLEncoder.encode(securityToken, "UTF-8");
    
            Class.forName("org.postgresql.Driver");
            Connection connection = DriverManager.getConnection(urlWithOptions, accessKeyId, accessKeySecret);
    
            Statement statement = connection.createStatement();
            ResultSet resultSet = statement.executeQuery("SELECT * FROM tabletest");
    
            // Process the resultSet
            while (resultSet.next()) {
                System.out.println("Result: " + resultSet.getInt(1));
                System.out.println("Result: " +  resultSet.getString(2));
            }
        }
    }

• PSQL客户端连接方式：Linux系统语句如下。更多操作信息，详情请参见PSQL客户端连接Hologres。

  PGUSER=<AccessKeyId> PGPASSWORD=<AccessKeySecret> PGOPTIONS="sts_token=<SecurityToken>" psql -h <host> -p <port> -d <database>

常见问题

RAM角色登录报错password authentication failed for user "<AccessKeyId>"，应当如何排查？

该错误表示可能存在AccessKeyId错误、AccessKeySecret错误、Security Token错误，或当前登录的用户尚未在Hologres实例中创建。建议按照以下顺序进行排查：

1. 检查实例内是否存在当前正在登录的用户。若不存在，可将RAM角色新增至该实例。详情请参见步骤二：添加RAM角色至Hologres实例并授权。

2. 检查Security Token传递方式是否正确，当通过URL进行传递时，需要经过URLEncoder.encode处理。

3. 检查AccessKeyId、AccessKeySecret和Security Token是否正确无误。