É possível usar a API Security Command Center para criar e atualizar fontes de segurança para gerar descobertas. Quando você adiciona uma fonte, o Security Command Center cria as fontes apropriadas e atribui a elas as permissões relevantes.
Os papéis do IAM para o Security Command Center podem ser concedidos no nível da organização, da pasta ou do projeto. A capacidade de ver, editar, criar ou atualizar descobertas, recursos e fontes de segurança depende do nível a que você tem acesso. Para saber mais sobre os papéis do Security Command Center, consulte Controle de acesso.
Antes de começar
Antes de configurar uma origem, é necessário autenticar com a API Security Command Center.
Como criar uma fonte
Este exemplo mostra como criar uma origem com um nome de exibição e uma descrição específicos que são usados no Security Command Center.
O servidor atribui automaticamente um ID à origem.
REST
Na API, faça uma solicitação para o método
organizations.sources.create. O corpo da solicitação contém uma instância de Source.
POST https://securitycenter.googleapis.com/v2/organizations/ORGANIZATION_ID/sources
{
"name": "SOURCE_NAME",
"description": "SOURCE_DESCRIPTION",
"displayName": "DISPLAY_NAME"
}
Substitua:
ORGANIZATION_ID: o ID da organização.SOURCE_NAME: o nome da origem.SOURCE_DESCRIPTION: uma descrição da origem (máximo: 1.024 caracteres).DISPLAY_NAME: o nome de exibição da origem (entre um e 64 caracteres).
Go
Java
Node.js
Python
A origem não fica visível no console do Security Command Center até que ela gere descobertas. Verifique se ela foi criada seguindo as instruções em Receber uma fonte específica.
Como atualizar uma fonte
Você pode atualizar o nome de exibição e a descrição de uma fonte depois que ela é criada. Você também pode usar uma máscara de campo para atualizar apenas um campo. O exemplo a seguir usa uma máscara de campo para atualizar apenas o nome de exibição, deixando a descrição inalterada.
REST
Na API, faça uma solicitação para o método organizations.sources.patch:
O corpo da solicitação contém uma instância de Source.
PATCH https://securitycenter.googleapis.com/v2/organizations/ORGANIZATION_ID/sources/SOURCE_ID?updateMask=displayName -d
{
"description": "SOURCE_DESCRIPTION",
"displayName": "DISPLAY_NAME",
}
Substitua:
ORGANIZATION_ID: o ID da organização.SOURCE_ID: o ID de origem. Para saber como encontrar um ID de origem, consulte Como conseguir o ID de origem.SOURCE_DESCRIPTION: uma descrição da origem (máximo: 1.024 caracteres).DISPLAY_NAME: o nome de exibição da origem (entre um e 64 caracteres).
Go
Java
Node.js
Python
Receber uma fonte específica
Verifique se uma origem foi criada ou atualizada corretamente. Para isso, consulte o Security Command Center com o nome do recurso absoluto da origem:
gcloud
gcloud scc sources describe ORGANIZATION_ID --source=SOURCE_ID
Substitua:
ORGANIZATION_ID: o ID da organização.SOURCE_ID: o ID da origem.
REST
Na API, faça uma solicitação ao método organizations.sources.get:
GET https://securitycenter.googleapis.com/v2/organizations/ORGANIZATION_ID/sources/SOURCE_ID
Substitua:
ORGANIZATION_ID: o ID da organização.SOURCE_ID: o ID da origem.
Go
Java
Node.js
Python
Como listar origens
O Security Command Center permite listar uma origem específica ou todas as origens disponíveis em uma organização:
REST
Na API, faça uma solicitação ao método organizations.sources.list:
GET https://securitycenter.googleapis.com/v2/organizations/ORGANIZATION_ID/sources
Substitua:
ORGANIZATION_ID: o ID da organização.
Go
Java
Node.js
Python
A seguir
- Saiba mais sobre as bibliotecas de cliente do Security Command Center.