Configurar a autenticação para o Productboard

info

Beta

Esse recurso está em Beta. Para usá-lo, um administrador do workspace deve ativar o Lakeflow Connect for Productboard na página Pré-visualizações . Consulte Gerenciar prévias do Databricks.

Para permitir a autenticação do conector Productboard do Lakeflow Connect, faça o registro de um aplicativo OAuth servidor para servidor no Productboard e faça o upload da key pública de um par de key RSA. O conector usa OAuth Servidor para Servidor do Productboard, assinando um JSON Web Token (JWT) com sua key privada. Use as credenciais recuperadas nos passos desta página para criar uma conexão Unity Catalog no Databricks.

Pré-requisitos

• Acesso de administrador ao workspace do Productboard. O Productboard requer acesso de administrador ao workspace para o registro de um aplicativo OAuth de servidor para servidor.
• Um usuário ativado do Productboard nesse workspace. O conector faz login como esse usuário, portanto, seu e-mail é o email do usuário na conexão.
• Uma ferramenta para gerar um par de key RSA, como o OpenSSL.

Configurar o Productboard

Faça o registro de um aplicativo OAuth Server-to-Server no Productboard e faça upload da metade pública de um par de key RSA. Para obter mais informações, consulte OAuth Server-to-Server na documentação do desenvolvedor do Productboard.

1. Gere um par de key RSA de pelo menos 2.048 bits no formato PEM. Por exemplo:

   Bash

   openssl genrsa -out productboard_private_key.pem 2048
   openssl rsa -in productboard_private_key.pem -pubout -out productboard_public_key.pem

2. Faça login no Productboard como administrador do workspace e acesse https://app.productboard.com/oauth2/applications.

3. Clique em Novo aplicativo .

4. Na página Nova aplicação OAuth , em Tipo de aplicação , selecione Servidor para servidor .

5. Em Nome , digite um nome para o aplicativo.

6. Em Workspace , selecione o workspace a partir do qual deseja ingerir. Você não pode alterar o workspace depois de criar o aplicativo.

7. Em key pública , cole o conteúdo de productboard_public_key.pem, incluindo as linhas -----BEGIN PUBLIC KEY----- e -----END PUBLIC KEY-----. Mantenha a key privada em seu sistema. O Productboard não emite um segredo de cliente para esse fluxo.

8. Em Escopos , na lista Escopos da API V2 , selecione os seguintes escopos de leitura que o conector solicita:

Escopo	tabelas
entities:read	features, products, components, feature_statuses, companies, users, release_groups, releases, objectives, key_results, initiatives, feature_relationships, component_relationships, field_definitions
notes:read	notes, note_field_definitions
members:read	members
teams:read	teams
members:pii:read	Emails não redigidos de proprietários e criadores em tabelas de entidades e notes, e nomes de membros, nomes de usuário e emails não redigidos em members.
users:pii:read	Nomes de usuário e emails não redigidos em users.

Escopo	tabelas
entities:read	features, products, components, feature_statuses, companies, users, release_groups, releases, objectives, key_results, initiatives, feature_relationships, component_relationships, field_definitions
notes:read	notes, note_field_definitions
members:read	members
teams:read	teams
members:pii:read	Emails não redigidos de proprietários e criadores em tabelas de entidades e notes, e nomes de membros, nomes de usuário e emails não redigidos em members.
users:pii:read	Nomes de usuário e emails não redigidos em users.

Se o aplicativo não tiver members:pii:read ou users:pii:read, o Productboard retornará [redacted] no lugar desses valores.

Selecione os escopos em API V2 Scopes , não em API V1 Scopes (Classic) . O conector usa a API v2 do Productboard. 9. Clique em Criar aplicativo .

10. Registre os seguintes valores. Você os insere ao criar uma conexão no Databricks:

    • O ID do cliente do aplicativo.
    • O endereço de email do usuário do Productboard ativado com o qual o conector inicia sessão.
    • O conteúdo completo do arquivo de key privada, incluindo as linhas -----BEGIN e -----END.

Os passos seguintes

Crie uma conexão do Productboard no Databricks. Veja Criar uma conexão com o Productboard.