Simulação de um ambiente de runbook

Para desenvolver novos runbooks, pode ser necessário ativar o RealmJoin.RunbookHelper para autenticar como se estivesse a ser executado dentro de um runbook.

Visão geral

Criar um Registro de Aplicativo

Criamos um Registro de Aplicativo do Azure para simular o início de sessão no estilo de aplicativo no Microsoft Entra.

Criar um Registro de Aplicativo

Conceder permissões

Concederemos as mesmas permissões que a identidade gerenciada teria. Usaremos o mesmo AppRoleGranter Toolkit para esse fim.

Substitua {AppRegObjectId} com o ID de objeto do seu registro de aplicativo.

git clone https://github.com/hcoberdalhoff/approle-and-directoryrole-granter.git
cd "approle-and-directoryrole-granter\RealmJoinVnext"
. .\AllInOne.ps1 -appRegObjectId "{AppRegObjectId}"

Criar e carregar um certificado de desenvolvimento

Ver aqui para um exemplo de como criar um certificado de desenvolvimento do RunbookHelper. Substitua {Variables} conforme necessário.

A {AppID} refere-se ao ID do aplicativo/cliente do Application Regsitrations.

Se você não tiver um ID de assinatura específico, basta usar uma assinatura padrão do seu Tenant. (Na maioria dos casos, isso não importa.)

New-SelfSignedCertificate -Subject 'CN=AzureRunAsConnection, OU={AppID}, DC={TenantID}, O={SubscriptionID}' `
    -CertStoreLocation "cert:\CurrentUser\My" -NotAfter (Get-Date).AddYears(10) -KeySpec Signature | `
    Export-Certificate -FilePath "AzureRunAsConnection.cer"

Você obterá um arquivo AzureRunAsConnection.cer que você carregará nos segredos do registro de aplicativos.

Se você quiser atender a vários aplicativos/ambientes, pode substituir o padrão "AzureRunAsConnection" emCN=AzureRunAsConnection por um nome personalizado ao criar o certificado para esse ambiente.

Você pode então selecionar qual ambiente/certificado (por exemplo, "OtherEnv") usar para se conectar usando Connect-RjRbGraph -AutomationConnectionName "OtherEnv"

Dessa forma, você pode acessar vários ambientes a partir da mesma máquina.

Carregamento do certificado

Utilização

Basta usar Connect-RjRbGraph para autenticar no aplicativo.

Certifique-se de remover certificados de desenvolvimento antigos usando o mmc.exe do seu conjunto de certificados pessoais, se houver, para evitar conflitos/falhas de login.