ใช้บัญชีบริการ

คุณสามารถใช้บัญชีบริการในปลั๊กอินจากชุมชนสำหรับใช้ลิงก์ข้อมูลเพื่อจัดการการเข้าถึงทรัพยากรแบบรวมศูนย์ Use Case โดยทั่วไปคือการมอบสิทธิ์การเข้าถึงข้อมูลที่ผู้ใช้ไม่สามารถเข้าถึงโดยใช้ข้อมูลเข้าสู่ระบบของตนเองได้

โปรดอ่านหัวข้อทำความเข้าใจบัญชีบริการเพื่อทำความคุ้นเคยกับหัวข้อ

ข้อดี

• คุณสามารถรวมการเรียกเก็บเงินสำหรับการเข้าถึงข้อมูลได้
• คุณสามารถใช้เลเยอร์การควบคุมการเข้าถึงของคุณเองในเครื่องมือเชื่อมต่อของคุณ
• คุณมอบสิทธิ์เข้าถึงข้อมูลหรือทรัพยากรที่ข้อมูลเข้าสู่ระบบของผู้ใช้ไม่มีสิทธิ์เข้าถึงได้

ขั้นตอนการใช้งาน

1. สร้างบัญชีบริการสำหรับแพลตฟอร์มที่ใช้ดึงข้อมูล
2. ให้สิทธิ์ที่จำเป็นแก่บัญชีบริการเพื่อให้เข้าถึงทรัพยากรที่จำเป็นได้
3. โปรดเก็บข้อมูลเข้าสู่ระบบของบัญชีบริการไว้ในพร็อพเพอร์ตี้สคริปต์ของเครื่องมือเชื่อมต่อ
4. ระหว่างการดำเนินการกับเครื่องมือเชื่อมต่อ ให้ใช้ข้อมูลเข้าสู่ระบบที่จัดเก็บไว้เพื่อดึงข้อมูลที่จำเป็น
5. ไม่บังคับ: ใช้ตรรกะการควบคุมการเข้าถึงเพื่อกรองข้อมูล

ข้อควรระวัง: อย่าเก็บข้อมูลเข้าสู่ระบบของบัญชีบริการไว้ในโค้ด ให้ใช้พร็อพเพอร์ตี้สคริปต์ของเครื่องมือเชื่อมต่อเพื่อให้แน่ใจว่าผู้ใช้คนอื่นๆ ที่มีสิทธิ์ดูโค้ดของคุณ (ไม่ว่าจะผ่าน Apps Script หรือที่เก็บโค้ดภายนอก) ก็จะไม่เห็นข้อมูลเข้าสู่ระบบ

ตัวอย่าง: การเข้าถึง BigQuery ด้วยบริการขั้นสูงของ Looker Studio และบัญชีบริการ

คุณกำลังสร้างโซลูชันที่ผู้ใช้จะสร้างหน้าแดชบอร์ดจากตาราง BigQuery หากผู้ใช้ใช้เครื่องมือเชื่อมต่อ BigQuery ของ Looker Studio ผู้ใช้ต้องมีสิทธิ์อ่านในตาราง BigQuery และจะต้องมีบัญชีสำหรับการเรียกเก็บเงิน สำหรับ Google Cloud Platform (GCP) ด้วย ขั้นตอนต่อไปนี้จะแสดงวิธีใช้บัญชีบริการเพื่อรวมการเรียกเก็บเงินและมอบสิทธิ์เข้าถึงข้อมูล BigQuery

1. สร้างบัญชีบริการในโปรเจ็กต์ GCP ที่ต้องการ
2. ตรวจสอบว่าบัญชีบริการสร้างงาน BigQuery และดูข้อมูลสำหรับตารางที่จำเป็นได้ โปรดดูรายละเอียดที่การควบคุมการเข้าถึง BigQuery
3. สร้างคีย์สำหรับบัญชีบริการและเก็บข้อมูลเข้าสู่ระบบในพร็อพเพอร์ตี้สคริปต์ของเครื่องมือเชื่อมต่อ
4. รวมไลบรารี OAuth2 Apps Script ไว้ในโปรเจ็กต์ Apps Script
5. สำหรับฟังก์ชัน getData ให้ตรวจสอบสิทธิ์บัญชีบริการและสร้างโทเค็นเพื่อการเข้าถึง กําหนดขอบเขต OAuth2 เป็น https://www.googleapis.com/auth/bigquery.readonly
6. โทเค็นเพื่อการเข้าถึงพร้อมกับรายการการกำหนดค่าอื่นๆ ในการตอบกลับ getData

ต่อไปนี้เป็นตัวอย่างที่สมบูรณ์ของโค้ดเครื่องมือเชื่อมต่อ

main.js

var cc = DataStudioApp.createCommunityConnector();
var scriptProperties = PropertiesService.getScriptProperties();

function isAdminUser() {
  return true;
}

function getAuthType() {
  var AuthTypes = cc.AuthType;
  return cc
    .newAuthTypeResponse()
    .setAuthType(AuthTypes.NONE)
    .build();
}

function getConfig(request) {
  var config = cc.getConfig();

  config
    .newInfo()
    .setId('generalInfo')
    .setText('This is an example connector to showcase row level security.');

  return config.build();
}

function getFields() {
  var fields = cc.getFields();
  var types = cc.FieldType;
  var aggregations = cc.AggregationType;

  fields
    .newDimension()
    .setId('region')
    .setName('Region')
    .setType(types.TEXT);

  fields
    .newMetric()
    .setId('sales')
    .setName('Sales')
    .setType(types.NUMBER)
    .setAggregation(aggregations.SUM);

  fields
    .newDimension()
    .setId('date')
    .setName('Date')
    .setType(types.YEAR_MONTH_DAY);

  return fields;
}

function getSchema(request) {
  return {schema: getFields().build()};
}

var SERVICE_ACCOUNT_CREDS = 'SERVICE_ACCOUNT_CREDS';
var SERVICE_ACCOUNT_KEY = 'private_key';
var SERVICE_ACCOUNT_EMAIL = 'client_email';
var BILLING_PROJECT_ID = 'project_id';

/**
 * Copy the entire credentials JSON file from creating a service account in GCP.
 */
function getServiceAccountCreds() {
  return JSON.parse(scriptProperties.getProperty(SERVICE_ACCOUNT_CREDS));
}

function getOauthService() {
  var serviceAccountCreds = getServiceAccountCreds();
  var serviceAccountKey = serviceAccountCreds[SERVICE_ACCOUNT_KEY];
  var serviceAccountEmail = serviceAccountCreds[SERVICE_ACCOUNT_EMAIL];

  return OAuth2.createService('RowLevelSecurity')
    .setAuthorizationBaseUrl('https://accounts.google.com/o/oauth2/auth')
    .setTokenUrl('https://accounts.google.com/o/oauth2/token')
    .setPrivateKey(serviceAccountKey)
    .setIssuer(serviceAccountEmail)
    .setPropertyStore(scriptProperties)
    .setCache(CacheService.getScriptCache())
    .setScope(['https://www.googleapis.com/auth/bigquery.readonly']);
}

var BASE_SQL =
  'SELECT d.region, d.sales, d.date ' +
  'FROM `datastudio-solutions.row_level_security.data` d ' +
  'INNER JOIN `datastudio-solutions.row_level_security.access` a ' +
  'ON d.region = a.region ' +
  'where a.email=@email';

function getData(request) {
  var accessToken = getOauthService().getAccessToken();
  var serviceAccountCreds = getServiceAccountCreds();
  var billingProjectId = serviceAccountCreds[BILLING_PROJECT_ID];
  var email = Session.getEffectiveUser().getEmail();

  var bqTypes = DataStudioApp.createCommunityConnector().BigQueryParameterType;

  return cc
    .newBigQueryConfig()
    .setAccessToken(accessToken)
    .setBillingProjectId(billingProjectId)
    .setUseStandardSql(true)
    .setQuery(BASE_SQL)
    .addQueryParameter('email', bqTypes.STRING, email)
    .build();
}