> For the complete documentation index, see [llms.txt](https://docs.scepman.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.scepman.com/pt/gestao-de-certificados/static-certificates/google-workspace.md).

# Google Workspace

Saiba como configurar e preparar o registo de certificados via SCEP para ChromeOS (Chromebook) usando o Chrome Enterprise e o SCEPman.

<img src="https://3802289327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FOcQ60dwuwNlrkOivBOFZ%2Ffile.excalidraw.svg?alt=media&amp;token=b8b92bf3-0ec6-4307-89ac-6c0ea5e978be" alt="" class="gitbook-drawing">

{% hint style="danger" %}
**O Google está descontinuando o SCEP legado para ChromeOS.** O Google anunciou que a API SCEP legada usada para o registro de certificados do ChromeOS será descontinuada até o final de 2026, em favor da nova **API de Provisionamento de Certificados do ChromeOS.**

Os certificados já emitidos via SCEP permanecerão válidos até expirarem, mas não poderão ser renovados depois que a API legada for descontinuada. O suporte do SCEPman para a API de Provisionamento de Certificados será abordado em um guia separado quando estiver disponível.

Para obter detalhes, veja [a documentação do Google sobre registro de certificados do ChromeOS](https://support.google.com/chrome/a/answer/11338941?hl=en).
{% endhint %}

## Fluxo de emissão de certificados SCEP

1. O Chromebook gera uma chave privada protegida por hardware.
2. O Google gera um CSR com o perfil SCEP.
3. O Connector encaminha o CSR para o SCEPman.
4. O SCEPman assina o CSR e envia o CRS assinado de volta ao conector, que o encaminha para o PubSub.
5. O PubSub envia o CRS assinado para o gerenciamento de dispositivos para armazenamento temporário.
6. O gerenciamento de dispositivos envia o CRS assinado para o Chromebook, onde ele é mesclado com a chave privada protegida por hardware. O CSR assinado é excluído do armazenamento temporário.

## Pré-requisitos

### Google Workspace

Este guia pressupõe que você já provisionou Chromebook(s) executando a versão 89 ou posterior do ChromeOS gerenciados com **Chrome Enterprise**.

<figure><img src="https://3802289327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FMeb9S7inigjfTB2l3ElO%2Fimage.png?alt=media&amp;token=a2f3daf6-fb40-4636-976f-9bd5e1e83ca4" alt=""><figcaption><p>Assinaturas mínimas necessárias</p></figcaption></figure>

### Google Cloud Certificate Connector (GCCC)

#### **Pré-requisitos**

* O GCCC requer um appliance ou VM do Windows Server executando Windows Server 2016 ou posterior.
* A instância do Windows Server deve ter o seguinte acesso à rede:
  * Saída: HTTP (80) e HTTPS (443).

#### **Instalação do GCCC**

1. Na sua Google **Console de administração** (em admin.google.com) > Vá para **Menu** > **Dispositivos** > **Rede**
2. Clique em **SCEP seguro** > **Baixar o conector**.
3. Na **Google Cloud Certificate Connector** seção, clique em **Baixar**. O download cria uma pasta na sua área de trabalho que contém o conector de certificados. Recomendamos que você baixe os outros arquivos de configuração do conector para essa pasta.
4. Na **Baixe o arquivo de configuração do conector** seção, clique em **Baixar**. O `config.json` arquivo é baixado.
5. Na **Obtenha uma chave de conta de serviço** seção, clique em **Gerar chave**. O `key.json` arquivo é baixado.
6. Execute o instalador do conector de certificados.
   1. No assistente de instalação, clique em **Avançar**.
   2. Aceite os termos do contrato de licença e clique em **Avançar**.
   3. Escolha a conta para a qual o serviço será instalado e clique em **Avançar**. A conta deve ter privilégios para fazer logon como um serviço no servidor Windows.
   4. Selecione o local de instalação. Recomendamos usar o padrão. Clique em **Avançar**.
   5. Insira as credenciais da sua conta de serviço e clique em **Avançar**. O serviço será instalado.
   6. Clique em **Concluir** para concluir a instalação.
7. Mova os arquivos de configuração e chave (`config.json` e `key.json`) para a pasta GCCC criada durante a instalação, normalmente: `C:\Program Files\Google Cloud Certificate Connector`.
8. Inicie o serviço do Google Cloud Certificate Connector:
   1. Abra os Serviços do Windows.
   2. Selecione **Google Cloud Certificate Connector** na lista de serviços.
   3. Clique em **Iniciar** para iniciar o serviço. Certifique-se de que o status mude para **Em execução**. O serviço é reiniciado automaticamente se o computador for reiniciado.

{% hint style="info" %}
Se você baixar uma nova chave de conta de serviço posteriormente, reinicie o serviço para aplicá-la.
{% endhint %}

### SCEPman

Ative a integração com o Google Workspace adicionando as seguintes variáveis de ambiente no serviço de aplicativo do SCEPman:

{% hint style="info" %}
Você pode diferenciar entre o SCEPman App Service e o Certificate Master procurando pelo App Service **sem** o "-cm" no nome
{% endhint %}

|                                                                                                            Configuração                                                                                                            | Descrição                                                                                                                                                                                                                                                                                                                                                |                        Valor                       |
| :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------: |
|                        [AppConfig:StaticValidation:Enabled](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-enabled)                       | Ativar validação de terceiros                                                                                                                                                                                                                                                                                                                            | ***true*** para ativar, ***false*** para desativar |
|                [AppConfig:StaticValidation:RequestPassword](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-requestpassword)               | <p>As solicitações de assinatura de certificado enviadas ao SCEPman para assinatura são autenticadas com esta senha estática segura<br><br><strong>Recomendação</strong>: Armazene este segredo em <a href="https://docs.scepman.com/pt/configuracao-do-scepman/application-settings.md#secure-configuration-in-azure-key-vault">Azure KeyVault</a>.</p> |          *gere uma senha de 32 caracteres*         |
|       [AppConfig:StaticValidation:ValidityPeriodDays](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-validityperioddays) (opcional)       | Número de dias em que os certificados emitidos via Google Workspace são válidos                                                                                                                                                                                                                                                                          |                         365                        |
| [AppConfig:StaticValidation:EnableCertificateStorage](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-enablecertificatestorage) (opcional) | Armazene os certificados solicitados na Storage Account, para exibi-los no SCEPman Certificate Master                                                                                                                                                                                                                                                    | ***true*** para ativar, ***false** para desativar* |

{% hint style="info" %}
Para mais informações e referências, visite [Ajuda do administrador do Google Workspace](https://support.google.com/a/answer/9366164?hl=en\&fl=1\&sjid=2941552975651362083-NC) ou baixe o guia original em PDF [Configuração do registro de certificados para ChromeOS via SCEP](https://support.google.com/chrome/a/answer/11338941?hl=en).

*Google, Google Workspace, ChromeOS e marcas e logotipos relacionados são marcas registradas da Google LLC.*
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.scepman.com/pt/gestao-de-certificados/static-certificates/google-workspace.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
