Clientes de serviço
Um cliente de serviço é um servidor, script ou job de CI pertencente ao projeto, que faz login com sua própria chave ou segredo em vez da aprovação de uma pessoa. Para criar ou alterar um cliente, o agente precisa de acesso Gerenciar para sua identidade com o escopo identity, de sua própria autorização Gerenciar com a capacidade project no projeto de destino e de uma pessoa responsável verificada que administre a organização desse projeto. Um cliente de serviço nunca gerencia clientes. Para executar comandos como o cliente, execute screenrig --config PATH login --client-id scl_ID --client-key-file KEY.pem (ou --client-secret-file FILE) uma vez e use essa configuração; screenrig logout remove o cliente salvo. Veja Clientes de serviço.
service-client list#
Listar os clientes de serviço deste projeto, ativos e revogados, com suas chaves, IDs secretas e uso.
service-client listSem parâmetros.
screenrig service-client listNunca retorna um segredo.
service-client show#
Exiba um cliente de serviço.
service-client show ID| Parâmetro | Tipo | Obrigatório | Padrão | Notas |
|---|---|---|---|---|
ID | string | sim | nenhum | O id do cliente, scl_…. |
screenrig service-client show scl_IDLista o kid de cada chave e o css_ de cada segredo para rotação.
service-client create#
Criar um cliente de serviço pertencente a este projeto.
service-client create --name NAME [--capability NAME]... [--access read|propose|manage]
[--uploader --folder-id IDS [--playlist-id IDS]] [--key-file PATH] [--secret-file PATH]| Parâmetro | Tipo | Obrigatório | Padrão | Notas |
|---|---|---|---|---|
--name NAME | string | sim | nenhum | 1 a 80 caracteres. |
--capability NAME | string | não | todos os seis | Repetível: screens, content, playlists, advertising, reports, project, cada um dentro do seu. |
--access LEVEL | string | não | ler | read, propose ou manage; propose para um uploader. propose envia alterações de playlist e tela para a revisão de uma pessoa. |
--uploader | boolean | não | desligado | Limite o cliente às pastas de mídia e playlists indicadas com --folder-id e --playlist-id. |
--folder-id IDS | string | com --uploader | nenhum | Pastas de mídia mfd_ separadas por vírgula nas quais o cliente faz upload; pelo menos uma. |
--playlist-id IDS | string | não | nenhum | Com --uploader: playlists pl_ separadas por vírgula cujas páginas o cliente altera. |
--key-file PATH | caminho | um destes | nenhum | Um JWK ou PEM: Ed25519, EC P-256 ou RSA de pelo menos 2048 bits. Apenas a metade pública é enviada. |
--secret-file PATH | caminho | um destes | nenhum | Gerar um segredo e gravá-lo neste novo arquivo 0600. Ele é exibido uma vez. |
screenrig service-client create --name "Nightly report" --access read --capability reports --key-file screenrig-client.pem
screenrig service-client create --name "Agency agent" --uploader --folder-id mfd_01EXAMPLEFOLDER000000000 --playlist-id pl_01EXAMPLEPLAYLIST000000 --secret-file agency.secretRequer as autorizações de identidade, projeto e administração da organização descritas acima. Um uploader trabalha apenas em suas pastas e playlists: faz upload de mídia nelas e adiciona, substitui e remove páginas dessas playlists, e qualquer outra coisa é outside_upload_scope. No máximo 50 clientes ativos por organização, contados em todos os seus projetos. Uma chave sem seu próprio kid é identificada pela impressão digital RFC 7638.
service-client add-key#
Registre uma segunda chave pública para uma rotação sem tempo de inatividade.
service-client add-key ID --key-file PATH| Parâmetro | Tipo | Obrigatório | Padrão | Notas |
|---|---|---|---|---|
ID | string | sim | nenhum | O id do cliente. |
--key-file PATH | caminho | sim | nenhum | A nova chave pública, um JWK ou PEM. |
screenrig service-client add-key scl_ID --key-file new.pemUm cliente possui no máximo duas chaves.
service-client add-secret#
Gerar um segundo segredo para uma rotação sem tempo de inatividade.
service-client add-secret ID --secret-file PATH| Parâmetro | Tipo | Obrigatório | Padrão | Notas |
|---|---|---|---|---|
ID | string | sim | nenhum | O id do cliente. |
--secret-file PATH | caminho | sim | nenhum | Um novo arquivo 0600 que recebe o segredo. |
screenrig service-client add-secret scl_ID --secret-file new-secretUm cliente possui no máximo dois segredos. O atual continua funcionando até que você o remova.
service-client remove-key#
Remover uma chave; tokens emitidos com ela param de funcionar em segundos.
service-client remove-key ID --kid KID| Parâmetro | Tipo | Obrigatório | Padrão | Notas |
|---|---|---|---|---|
ID | string | sim | nenhum | O id do cliente. |
--kid KID | string | sim | nenhum | O id da chave de service-client show. |
screenrig service-client remove-key scl_ID --kid KIDUm cliente mantém pelo menos uma chave ou segredo.
service-client remove-secret#
Remover um segredo; tokens emitidos com ele param de funcionar em segundos.
service-client remove-secret ID --secret-id css_ID| Parâmetro | Tipo | Obrigatório | Padrão | Notas |
|---|---|---|---|---|
ID | string | sim | nenhum | O id do cliente. |
--secret-id ID | string | sim | nenhum | O id secreto css_ de service-client show. |
screenrig service-client remove-secret scl_ID --secret-id css_IDUm cliente mantém pelo menos uma chave ou segredo.
service-client revoke#
Revogar permanentemente um cliente de serviço.
service-client revoke ID --yes| Parâmetro | Tipo | Obrigatório | Padrão | Notas |
|---|---|---|---|---|
ID | string | sim | nenhum | O id do cliente. |
--yes | boolean | sim | desligado | Confirme a revogação permanente. |
screenrig service-client revoke scl_ID --yesExclui suas chaves e segredos; seus tokens param de funcionar em segundos. O registro permanece para auditoria.