# configuração de fonte no PingIdentity PingOne
<a name="pingidentity-pingone-source-setup"></a>

## Integrar com o PingIdentity PingOne
<a name="pingidentity-pingone-integration"></a>

O PingOne é a plataforma de identidade como serviço (IDaaS) baseada em nuvem da Ping Identity que fornece recursos de gerenciamento de identidade e acesso. O CloudWatch Pipeline usa a API Audit Logs do PingOne para recuperar informações sobre eventos de autenticação, atividades de usuários, decisões de políticas e mudanças administrativas em todo o ambiente do PingOne. A API Audit Logs permite acesso a dados de eventos por endpoints de REST, possibilitando a recuperação de logs de segurança e acesso da sua organização do PingOne.

## Autenticar no PingIdentity PingOne
<a name="pingidentity-pingone-authentication"></a>

Para ler os logs, o pipeline precisa ser autenticado no ambiente do PingOne. No PingOne, a autenticação é realizada com o OAuth2.

**Configurar a autenticação OAuth2 para o PingOne**
+ Entre no console do PingOne e navegue até Aplicações → Aplicações. Crie uma nova aplicação do tipo Operador. Anote o ID do cliente e o ID do ambiente.
+ Gere um novo segredo do cliente na guia Configuração. Copie o segredo imediatamente.
+ No AWS Secrets Manager, crie um segredo e armazene o ID do cliente com a chave `client_id` e o segredo do cliente com a chave `client_secret`.
+ Atribua à aplicação os perfis de administrador do ambiente e de proprietário da aplicação.
+ Identifique sua região do PingOne (NA, UE, AP, AU, CA, SG).
+ Anote o ID do ambiente de Configurações → Ambiente → Propriedades.

## Configurar o CloudWatch Pipeline
<a name="pingidentity-pingone-pipeline-config"></a>

Para configurar o pipeline para ler logs, escolha o PingOne como a fonte de dados. Preencha as informações necessárias, como a ID do ambiente. Opcionalmente, especifique a região (o padrão é NA) e o formato de duração do intervalo (por exemplo, PT21H para as últimas 21 horas). O intervalo padrão é de 0 horas, e o máximo é de 90 dias. Depois que o pipeline é criado e ativado, os dados de log de auditoria do PingOne começam a fluir para o grupo de logs selecionado do CloudWatch Logs.

## Classes de eventos do Open Cybersecurity Schema Framework compatíveis
<a name="pingidentity-pingone-ocsf-events"></a>

Essa integração é compatível com o esquema OCSF versão v1.5.0 e eventos do PingOne que são mapeados para Account Change (3001), Authentication (3002) e Entity Management (3004).

**Account Change** inclui os seguintes eventos:
+ USER.CREATED
+ USER.INVITED
+ USER.REINVITED
+ USER.INVITE\_ACCEPTED
+ PASSWORD.FORCE\_CHANGE
+ PASSWORD.RECOVERY
+ PASSWORD.RESET
+ USER.INVITE\_REVOKED
+ USER.DELETED
+ USER.LOCKED
+ MFA\_SETTINGS.UPDATED
+ PASSWORD.UNLOCKED
+ USER.UNLOCKED

**Authentication** inclui os seguintes eventos:
+ AUTHENTICATION.CREATED
+ RADIUS\_SESSION.CREATED
+ SESSION.CREATED
+ SESSION.UPDATED
+ SESSION.DELETED
+ USER.SLO\_FAILURE
+ USER.SLO\_PARTIAL\_LOGOUT
+ USER.SLO\_REQUESTED
+ USER.SLO\_SUCCESS
+ USER.KERBEROS\_FAILED
+ USER.KERBEROS\_SUCCEEDED
+ DEVICE.ACTIVATION\_OTP\_FAILED
+ DEVICE.ACTIVATION\_OTP\_INVALID
+ DEVICE\_PAYLOAD.CHECK\_INVALID
+ DEVICE\_PAYLOAD.CHECK\_SUCCESS
+ OTP.CHECK\_FAILED
+ OTP.CHECK\_INVALID
+ OTP.CHECK\_SUCCESS
+ PASSWORD.CHECK\_FAILED
+ PASSWORD.CHECK\_SUCCEEDED

**Entity Management** inclui os seguintes eventos:
+ ACTION.CREATED
+ AGREEMENT.CREATED
+ AGREEMENT\_LANGUAGE.CREATED
+ AGREEMENT\_LANGUAGE\_REVISION.CREATED
+ APPLICATION.CREATED
+ AUTHORIZE\_POLICY.CREATED
+ CERTIFICATE.CREATED
+ DEVICE.CREATED
+ DEVICE\_AUTHENTICATION\_POLICY.CREATED
+ FIDO\_POLICY.CREATED
+ FLOW.CREATED
+ FLOW\_DEFINITION.CREATED
+ FLOW\_EXECUTION.CREATED
+ GROUP.CREATED
+ IDENTITY\_PROVIDER.CREATED
+ IDP\_ATTRIBUTE.CREATED
+ INSTANT\_MESSAGING\_DELIVERY\_SETTINGS.CREATED
+ KEY.CREATED
+ LICENSE.CREATED
+ NOTIFICATION.CREATED
+ NOTIFICATION\_POLICY.CREATED
+ ORGANIZATION.CREATED
+ POLICY.CREATED
+ RISK\_POLICY\_SET.CREATED
+ SAML\_ATTRIBUTE.CREATED
+ SCHEMA\_ATTRIBUTE.CREATED
+ SIGN\_ON\_POLICY\_ASSIGNMENT.CREATED
+ VERIFY\_POLICY.CREATED
+ CERTIFICATE.READ
+ KEY.READ
+ SECRET.READ
+ ACTION.UPDATED
+ ADMIN\_CONFIGURATION.UPDATED
+ AGREEMENT.UPDATED
+ AGREEMENT\_LANGUAGE.UPDATED
+ AGREEMENT\_LANGUAGE\_REVISION.UPDATED
+ APPLICATION.UPDATED
+ AUTHORIZE\_POLICY.UPDATED
+ CERTIFICATE.UPDATED
+ DEVICE.NICKNAME\_UPDATED
+ DEVICE.UPDATED
+ DEVICE\_AUTHENTICATION\_POLICY.UPDATED
+ FIDO\_POLICY.UPDATED
+ FLOW.UPDATED
+ FLOW\_DEFINITION.UPDATED
+ FLOW\_EXECUTION.UPDATED
+ GROUP.UPDATED
+ IDENTITY\_PROVIDER.UPDATED
+ IDP\_ATTRIBUTE.UPDATED
+ INSTANT\_MESSAGING\_DELIVERY\_SETTINGS.UPDATED
+ KEY.UPDATED
+ LICENSE.UPDATED
+ NOTIFICATION.UPDATED
+ NOTIFICATION\_POLICY.UPDATED
+ NOTIFICATIONS\_SETTINGS.UPDATED
+ ORGANIZATION.UPDATED
+ POLICY.UPDATED
+ RISK\_POLICY\_SET.ORDER\_UPDATED
+ RISK\_POLICY\_SET.UPDATED
+ SAML\_ATTRIBUTE.UPDATED
+ SCHEMA\_ATTRIBUTE.UPDATED
+ SECRET.UPDATED
+ SETTINGS.UPDATED
+ SIGN\_ON\_POLICY\_ASSIGNMENT.UPDATED
+ USER.QUOTA\_RESET
+ USER.UPDATED
+ VERIFY\_POLICY.UPDATED
+ ACTION.DELETED
+ AGREEMENT.DELETED
+ AGREEMENT\_LANGUAGE.DELETED
+ AGREEMENT\_LANGUAGE\_REVISION.DELETED
+ APPLICATION.DELETED
+ AUTHORIZE\_POLICY.DELETED
+ CERTIFICATE.DELETED
+ DEVICE.DELETED
+ DEVICE\_AUTHENTICATION\_POLICY.DELETED
+ FIDO\_POLICY.DELETED
+ FLOW.DELETED
+ FLOW\_DEFINITION.DELETED
+ GROUP.DELETED
+ IDENTITY\_PROVIDER.DELETED
+ IDP\_ATTRIBUTE.DELETED
+ INSTANT\_MESSAGING\_DELIVERY\_SETTINGS.DELETED
+ KEY.DELETED
+ LICENSE.DELETED
+ NOTIFICATION\_POLICY.DELETED
+ ORGANIZATION.DELETED
+ POLICY.DELETED
+ RISK\_POLICY\_SET.DELETED
+ SAML\_ATTRIBUTE.DELETED
+ SCHEMA\_ATTRIBUTE.DELETED
+ SIGN\_ON\_POLICY\_ASSIGNMENT.DELETED
+ VERIFY\_POLICY.DELETED
+ DEVICE.UNBLOCKED
+ DEVICE.BLOCKED
+ NOTIFICATION.REJECTED
+ DEVICE.ACTIVATED
+ DEVICE.LOCKED
+ DEVICE.UNLOCKED
+ ROLE.CREATED
+ ROLE.UPDATED
+ ROLE.DELETED