Integrar o Google Formulários ao Google SecOps
Neste documento, explicamos como integrar o Google Formulários ao Google Security Operations (Google SecOps).
Antes de começar
Antes de configurar a integração do Google Formulários no Google SecOps, verifique se os ambientes do Google Cloud e do Google Workspace estão preparados para acesso à API e personificação.
Para que a integração funcione corretamente, três elementos precisam estar alinhados para gerenciar as permissões:
Conta de serviço: atua como a ponte entre os sistemas.
Usuário delegado: a identidade temporária de conta de serviço que a conta de serviço personifica para acessar os dados do formulário.
Permissões: os escopos e papéis que definem o que a identidade pode fazer.
Se o usuário que você está personificando já tiver as permissões administrativas necessárias, não será preciso criar um papel personalizado. No entanto, muitas organizações preferem criar um usuário de serviço dedicado com um papel personalizado para aderir ao princípio de privilégio mínimo.
Siga estas etapas de pré-requisito:
- Crie uma conta de serviço.
- Crie uma chave JSON.
- Ative as APIs necessárias para seu projeto.
- Opcional: criar um papel personalizado para a integração.
- Opcional: atribua o papel personalizado a um usuário.
- Delegue autoridade em todo o domínio para sua conta de serviço.
Criar uma conta de serviço
A conta de serviço representa um usuário não humano que fornece uma maneira segura para a integração autenticar e ser autorizada a acessar seus dados.
No console do Google Cloud , acesse a página Credenciais.
Selecione add_2Criar credenciais > Conta de serviço.
Em Detalhes da conta de serviço, insira um nome no campo Nome da conta de serviço.
Opcional: edite o ID da conta de serviço.
Clique em Concluído.
Criar uma chave JSON
O Google SecOps exige um arquivo de chave JSON para comprovar a identidade da conta de serviço e estabelecer uma conexão segura.
Selecione sua conta de serviço e acesse Chaves.
Clique em Adicionar chave > Criar nova chave.
Para o tipo de chave, selecione JSON e clique em Criar. Uma caixa de diálogo Chave privada salva no seu computador é exibida, e uma cópia da chave privada é salva no seu computador.
Ative as APIs necessárias para seu projeto
Você precisa ativar as APIs específicas do Google Cloud que permitem que a integração interaja com o Google Formulários e o diretório do Google Workspace.
No console do Google Cloud , acesse APIs e serviços.
Clique em addAtivar APIs e serviços.
Ative as seguintes APIs no seu projeto:
API Admin SDK
API do Google Formulários
Opcional: criar um papel personalizado para a integração
Se a conta de usuário que você está usando para personificação ainda não tiver as permissões administrativas necessárias, crie um papel personalizado com privilégios limitados. Para oferecer suporte à integração, o usuário precisa de privilégios da API Admin para o seguinte:
Unidades organizacionais
Usuários
Grupos
No Google Admin Console, acesse Conta > Funções do administrador.
Selecione Criar função.
Dê um nome para a nova função personalizada e clique em Continuar.
Em Selecionar privilégios, localize a seção Privilégios da API Admin.
Marque as caixas de seleção de Unidades organizacionais, Usuários e Grupos.
Clique em Continuar > Criar papel.
Opcional: atribuir o papel personalizado a um usuário
Se você criou um papel personalizado na etapa anterior, agora é necessário atribuí-lo ao endereço de e-mail específico que está sendo usado para personificação.
No Google Admin Console, acesse Diretório > Usuários.
Selecione o usuário que você quer usar para a integração (um administrador atual ou um novo usuário dedicado).
Abra as configurações do usuário e clique em Funções e privilégios do administrador > editar Editar.
Selecione a função personalizada que você criou e mude o botão para Atribuída.
Clique em Salvar.
Delegar autoridade em todo o domínio à conta de serviço
A delegação em todo o domínio permite que sua conta de serviço acesse dados em todo o domínio do Google Workspace, personificando o usuário autorizado.
No Google Admin Console do seu domínio, acesse Segurança > Controle de dados e acesso > Controles de API.
No painel Delegação em todo o domínio, selecione Gerenciar a delegação em todo o domínio.
Clique em Adicionar novo.
No campo ID do cliente, insira o ID do cliente da conta de serviço criada na primeira etapa.
No campo Escopos do OAuth, insira a seguinte lista de escopos obrigatórios separada por vírgulas:
https://mail.google.com/, https://www.googleapis.com/auth/admin.directory.customer.readonly, https://www.googleapis.com/auth/admin.directory.domain.readonly, https://www.googleapis.com/auth/admin.directory.group, https://www.googleapis.com/auth/admin.directory.group.member, https://www.googleapis.com/auth/admin.directory.orgunit, https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly, https://www.googleapis.com/auth/admin.directory.user, https://www.googleapis.com/auth/admin.directory.user.alias, https://www.googleapis.com/auth/apps.groups.settings, https://www.googleapis.com/auth/cloud-platform, https://www.googleapis.com/auth/forms.body.readonly, https://www.googleapis.com/auth/forms.responses.readonlyClique em Autorizar.
Parâmetros de integração
A integração do Google Formulários requer os seguintes parâmetros:
| Parâmetro | Descrição |
|---|---|
Delegated Email |
Obrigatório Um endereço de e-mail a ser usado para a representação e o controle de acesso. |
Service Account JSON |
Obrigatório O conteúdo do arquivo JSON da chave da conta de serviço. |
Verify SSL |
Obrigatório Se selecionada, a integração verifica se o certificado SSL para se conectar ao Google Formulários é válido. Essa configuração é selecionada por padrão. |
Para instruções sobre como configurar uma integração no Google SecOps, consulte Configurar integrações.
Se necessário, você pode fazer mudanças depois. Depois de configurar uma instância de integração, é possível usá-la em playbooks. Para mais informações sobre como configurar e oferecer suporte a várias instâncias, consulte Como oferecer suporte a várias instâncias.
Ações
Para mais informações sobre ações, consulte Responder a ações pendentes na sua mesa de trabalho e Executar uma ação manual no seu caso.
Ping
Use a ação Ping para testar a conectividade com o Google Formulários.
Essa ação não é executada em entidades do Google SecOps.
Entradas da ação
Nenhuma.
Saídas da ação
A ação Ping fornece as seguintes saídas:
| Tipo de saída da ação | Disponibilidade |
|---|---|
| Anexo do Painel de Casos | Indisponível |
| Link do Painel de Casos | Indisponível |
| Tabela do painel de casos | Indisponível |
| Tabela de enriquecimento | Indisponível |
| Resultado JSON | Indisponível |
| Mensagens de saída | Disponível |
| Resultado do script | Disponível |
Mensagens de saída
A ação Ping pode retornar as seguintes mensagens de saída:
| Mensagem de resposta | Descrição da mensagem |
|---|---|
Successfully connected to the Google Forms server with the
provided connection parameters! |
A ação foi concluída. |
Failed to connect to the Google Forms server! Error is
ERROR_REASON |
A ação falhou. Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais. |
Resultado do script
A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Ping:
| Nome do resultado do script | Valor |
|---|---|
is_success |
True ou False |
Conectores
Para instruções detalhadas sobre como configurar um conector no Google SecOps, consulte Ingerir seus dados (conectores).
Google Formulários – Conector de respostas
Use o conector do Google Formulários – Respostas para extrair respostas do Google Formulários.
O conector do Google Formulários – Respostas requer os seguintes parâmetros:
| Parâmetro | Descrição |
|---|---|
Product Field Name |
Obrigatório O nome do campo em que o nome do produto é armazenado. O valor padrão é |
Event Field Name |
Obrigatório O nome do campo usado para determinar o nome do evento (subtipo). O valor padrão é |
Environment Field Name |
Opcional
O nome do campo em que o nome do ambiente é armazenado. Se o campo de ambiente não for encontrado, o ambiente será definido como o padrão. O valor padrão é |
Environment Regex Pattern |
Opcional
Um padrão de expressão regular a ser executado no valor encontrado no campo Use o valor padrão Se o padrão de expressão regular for nulo ou vazio, ou se o valor do ambiente for nulo, o resultado final será o ambiente padrão. |
Script Timeout (Seconds) |
Obrigatório O limite de tempo limite em segundos para o processo do Python que executa o script atual. O valor padrão é de 300 segundos. |
Delegated Email |
Obrigatório Um endereço de e-mail a ser usado para a representação e o controle de acesso. |
Service Account JSON |
Obrigatório O conteúdo do arquivo JSON da chave da conta de serviço. |
Form IDs To Track |
Obrigatório Uma lista separada por vírgulas de IDs do Google Formulários para rastrear respostas. Para recuperar o ID exclusivo de um formulário, abra-o no editor do Formulários
(não o link de resposta público) e copie a string localizada entre
|
Alert Severity |
Opcional Um nível de gravidade a ser atribuído a todos os alertas que o conector cria com base na resposta do formulário do Google Formulários. Os valores possíveis são os seguintes:
O valor padrão é |
Max Hours Backwards |
Obrigatório Um número de horas antes da primeira iteração do conector para recuperar as respostas. Esse parâmetro se aplica à iteração inicial do conector depois que você o ativa pela primeira vez ou ao valor substituto de um carimbo de data/hora expirado do conector. O valor padrão é 1 hora. |
Max Responses To Fetch |
Obrigatório O número máximo de respostas a serem processadas para cada iteração do conector. O número máximo é 100. |
Disable Overflow |
Opcional Se selecionado, o conector ignora o mecanismo de estouro do Google SecOps durante a criação do alerta. Não selecionada por padrão. |
Verify SSL |
Obrigatório Se selecionada, a integração verifica se o certificado SSL para se conectar ao Google Formulários é válido. Não selecionado por padrão. |
Proxy Server Address |
Opcional O endereço do servidor proxy a ser usado. |
Proxy Username |
Opcional O nome de usuário do proxy para autenticação. |
Proxy Password |
Opcional A senha do proxy para autenticação. |
Regras do conector
O conector do Google Formulários – Respostas é compatível com proxies.
Eventos do conector
O exemplo a seguir mostra a saída JSON de um evento do Google SecOps gerado pelo conector de respostas do Google Formulários:
{
"responseId": "RESPONSE_ID",
"createTime": "2024-09-05T11:43:13.892Z",
"lastSubmittedTime": "2024-09-05T11:43:13.892123Z",
"event_type": "Question",
"questionId": "78099fe3",
"textAnswers": {
"answers": [
{
"value": "Option 1"
}
]
}
}
Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.