Log de chamadas de API do AWS CodeStar com o AWS CloudTrail - AWS CodeStar

Em 31 de julho de 2024, a Amazon Web Services (AWS) interromperá o suporte para criação e visualização AWS CodeStar de projetos. Depois de 31 de julho de 2024, você não poderá mais acessar o AWS CodeStar console nem criar novos projetos. No entanto, os AWS recursos criados por AWS CodeStar, incluindo seus repositórios de origem, pipelines e compilações, não serão afetados por essa alteração e continuarão funcionando. AWS CodeStar As conexões e AWS CodeStar notificações não serão afetadas por essa descontinuação.

 

Se você deseja monitorar o trabalho, desenvolver código e criar, testar e implantar seus aplicativos, a Amazon CodeCatalyst fornece um processo de introdução simplificado e funcionalidades adicionais para gerenciar seus projetos de software. Saiba mais sobre a funcionalidade e os preços da Amazon CodeCatalyst.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Log de chamadas de API do AWS CodeStar com o AWS CloudTrail

O AWS CodeStar é integrado ao AWS CloudTrail, um serviço que fornece um registro das ações realizadas por um usuário, uma função ou um serviço da AWS no AWS CodeStar. O CloudTrail captura as chamadas de API do AWS CodeStar como eventos. As chamadas capturadas incluem as chamadas do console do AWS CodeStar e as chamadas de código para as operações da API do AWS CodeStar. Se você criar uma trilha, poderá habilitar a entrega contínua de eventos do CloudTrail para um bucket do S3, incluindo eventos para o AWS CodeStar. Se você não configurar uma trilha, ainda poderá visualizar os eventos mais recentes no console do CloudTrail em Event history (Histórico de eventos). Ao usar as informações coletadas pelo CloudTrail, é possível determinar a solicitação feita ao AWS CodeStar, o endereço IP do qual a solicitação foi feita, quem a fez e quando ela foi feita, além de outros detalhes.

Para saber mais sobre o CloudTrail, consulte o Guia do usuário do AWS CloudTrail.

Informações do AWS CodeStar no CloudTrail

O CloudTrail é habilitado em sua conta da AWS quando ela é criada. Quando ocorre uma atividade no AWS CodeStar, essa atividade é registrada em um evento do CloudTrail com outros eventos de produtos da AWS em Event history (Histórico de eventos). Você pode visualizar, pesquisar e baixar os eventos recentes em sua conta da AWS. Para obter mais informações, consulte Como visualizar eventos com o histórico de eventos do CloudTrail.

Para obter um registro contínuo de eventos na conta da AWS, incluindo eventos do AWS CodeStar, crie uma trilha. Por padrão, quando você cria uma trilha no console, ela é aplicada a todas as regiões da AWS. A trilha registra eventos de todas as regiões na partição da AWS e fornece os arquivos de log ao bucket do S3 que você especificar. Você pode configurar outros serviços da AWS para analisar e atuar mais profundamente sobre os dados de eventos coletados nos logs do CloudTrail. Para obter mais informações, consulte as informações a seguir.

Todas as ações do AWS CodeStar são registradas pelo CloudTrail e são documentadas na Referência de API do AWS CodeStar. Por exemplo, as chamadas para as APIs DescribeProject, UpdateProject e AssociateTeamMember geram entradas nos arquivos de log do CloudTrail.

Cada entrada de log ou evento contém informações sobre quem gerou a solicitação. As informações de identidade ajudam a determinar:

  • Se a solicitação foi feita com credenciais de usuário raiz ou do usuário do IAM.

  • Se a solicitação foi feita com credenciais de segurança temporárias de uma função ou de um usuário federado.

  • Se a solicitação foi feita por outro serviço da AWS.

Para obter mais informações, consulte o Elemento userIdentity do CloudTrail.

Noções básicas das entradas dos arquivos de log do AWS CodeStar

Os arquivos de log do CloudTrail contêm uma ou mais entradas de log. Um evento representa uma única solicitação de qualquer fonte e inclui informações sobre a ação solicitada, a data e a hora da ação, os parâmetros de solicitação e assim por diante. Os arquivos de log do CloudTrail não são um rastreamento de pilha ordenada de chamadas de API pública. Dessa forma, eles não são exibidos em uma ordem específica.

O exemplo a seguir mostra uma entrada do log do CloudTrail que demonstra uma operação do CreateProject sendo chamada no AWS CodeStar:

{ "eventVersion": "1.05", "userIdentity": { "type": "AssumedRole", "principalId": "AROAJLIN2OF3UBEXAMPLE:role-name", "arn": "arn:aws:sts::account-ID:assumed-role/role-name/role-session-name", "accountId": "account-ID", "accessKeyId": "ASIAJ44LFQS5XEXAMPLE", "sessionContext": { "attributes": { "mfaAuthenticated": "false", "creationDate": "2017-06-04T23:56:57Z" }, "sessionIssuer": { "type": "Role", "principalId": "AROAJLIN2OF3UBEXAMPLE", "arn": "arn:aws:iam::account-ID:role/service-role/role-name", "accountId": "account-ID", "userName": "role-name" } }, "invokedBy": "codestar.amazonaws.com" }, "eventTime": "2017-06-04T23:56:57Z", "eventSource": "codestar.amazonaws.com", "eventName": "CreateProject", "awsRegion": "region-ID", "sourceIPAddress": "codestar.amazonaws.com", "userAgent": "codestar.amazonaws.com", "requestParameters": { "clientRequestToken": "arn:aws:cloudformation:region-ID:account-ID:stack/stack-name/additional-ID", "id": "project-ID", "stackId": "arn:aws:cloudformation:region-ID:account-ID:stack/stack-name/additional-ID", "description": "AWS CodeStar created project", "name": "project-name", "projectTemplateId": "arn:aws:codestar:region-ID::project-template/project-template-name" }, "responseElements": { "projectTemplateId": "arn:aws:codestar:region-ID::project-template/project-template-name", "arn": "arn:aws:codestar:us-east-1:account-ID:project/project-ID", "clientRequestToken": "arn:aws:cloudformation:region-ID:account-ID:stack/stack-name/additional-ID", "id": "project-ID" }, "requestID": "7d7556d0-4981-11e7-a3bc-dd5daEXAMPLE", "eventID": "6b0d6e28-7a1e-4a73-981b-c8fdbEXAMPLE", "eventType": "AwsApiCall", "recipientAccountId": "account-ID" }