Para usar a API Chrome Printer Management, é necessário ativar a API e criar as credenciais do OAuth 2.0 do app. Em seguida, um administrador do Chrome precisa conceder a seu script o acesso necessário à conta para gerenciar impressoras. Os administradores também podem bloquear ou confiar em apps desenvolvidos para gerenciar impressoras na conta.
Siga as etapas abaixo para configurar tudo que é necessário para acessar a API. Para seguir estas instruções, é necessário ter um app com a tela de permissão OAuth configurada e uma conta de serviço configurada. Se esse não for o caso, consulte Configurar o consentimento do OAuth e Criar uma conta de serviço antes de continuar.
Ativar a API e criar credenciais
- Ative a API. A API que você está ativa é "SDK Admin".
- Crie credenciais do OAuth 2.0 para sua conta de serviço. Armazene o arquivo JSON salvo em um local seguro.
Ativar o acesso à conta de serviço
Antes de usar, sua conta de serviço precisa receber privilégios de administrador adequados. Isso precisa ser feito por um administrador do cliente associado às impressoras ou aos servidores de impressão que a conta de serviço gerencia.
Opção 1: ativar a delegação em todo o domínio para a conta de serviço
A delegação em todo o domínio permite que a conta de serviço represente um administrador com os privilégios adequados para gerenciar impressoras e servidores de impressão.
Ativar a delegação em todo o domínio
O escopo do OAuth necessário para esta etapa é
https://www.googleapis.com/auth/admin.chrome.printers
.
Opção 2: conceder privilégios de função de administrador à conta de serviço
Se preferir limitar os privilégios da conta de serviço no domínio, atribua a ela um papel com privilégios para gerenciar apenas impressoras. Para saber mais sobre o uso de papéis para controle de acesso, consulte Gerenciar papéis.
- Como administrador, faça login no Admin Console.
- No canto superior esquerdo da página, clique em > Conta > Papéis de administrador.
Selecione um papel com o privilégio abaixo ou crie um novo e adicione este privilégio:
Services > ChromeOS > Settings > Manage Printers
Atribua este papel ao endereço de e-mail da conta de serviço.
Bloquear ou confiar em um app de gerenciamento de impressoras
Os apps são confiáveis por padrão, mas um administrador pode optar por bloquear ou confiar em apps específicos na conta.
- Como administrador, faça login no Admin Console.
- No canto superior esquerdo, clique em Menu > Controle de acesso e dados > Controles de API. > Segurança
- Na seção "Controle de acesso de apps", clique em Gerenciar o acesso de apps de terceiros.
- Na seção "Apps conectados":
- Se ele não aparecer, clique em Configurar novo app e siga as instruções exibidas na tela.
- Se o app aparecer na lista, clique no nome dele. Depois, selecione "Bloqueado" ou "Confiável" em "Acesso de apps" e clique em Salvar.