Logotipo do PowerShell

Você já quis delegar uma tarefa, mas descobriu que as permissões necessárias podem ser muito arriscadas para distribuir? Ou você queria bloquear coisas como a criação de grupos no AD para impor convenções de nomenclatura de grupos?

A JEA pode ajudá-lo com isso e muito mais. Neste artigo, mostraremos como você pode delegar seus scripts já criados com o PowerShell 5.1.

O que é o JEA?

O JEA é uma solução PowerShell da Microsoft que pode restringir usuários (e administradores) para poder executar apenas tarefas especificadas em uma sessão específica do PowerShell, mesmo que exijam administrador local no recurso mencionado. Além disso, você pode ser extremamente específico. Somente os comandos que você especificar podem ser executados, é possível ativar apenas valores de parâmetros específicos e valores de parâmetros que correspondam a um padrão específico.

Por exemplo, você pode ativar o Servicedesk para reiniciar apenas um serviço específico com Reiniciar serviçoou adicione apenas grupos ao AD de acordo com uma convenção de nomenclatura específica. Você pode fazer tudo isso sem conceder permissões explícitas em um servidor ou no AD. É uma ferramenta que pode economizar uma quantidade enorme de tempo e proteger seu ambiente. Vamos começar envolvendo nosso script em uma função.

Etapa 1: Criando uma função a partir do seu script

A primeira etapa, se você ainda não o fez, é criar uma função do seu script. Isso é bastante fácil, supondo que você já tenha seu parâmetros configuração. Abaixo, envolvi meu script simples "New-FolderAndShare" em uma função:

Função New-FolderAndShare {     (cmdletbinding ())     param (         # Nome do compartilhamento         (parâmetro (obrigatório))         (ValidatePattern ("^ (Projeto d {5} | Equipe (Finanças | RH | TI | Multi) (a-z) +) $")))         (string) $ ShareName,         # Diretório da nova pasta de compartilhamento localmente         (parâmetro (obrigatório))         (ValidatePattern ("^ (D | E | F): \ ações \ $"))         (string) $ Caminho,         # Quem tem acesso completo         (parâmetro (obrigatório))         (ValidateSet ("^ CONTOSO \"))         (string) $ FullAccess     )         $ FullPath = caminho da junção $ Path $ ShareName     Diretório New-Item -ItemType -Path $ FullPath     New-SmbShare -Path $ FullPath -Nome $ ShareName -FullAccess $ FullAccess }

Você valida os parâmetros com ValidatePattern na função, mas se isso fazia parte de um módulo, você poderia fazer isso no arquivo RoleCapabilities em vez de VisibleFunctions.

Tornar o script uma função nos dá maior controle de quais parâmetros são permitidos no JEA e facilita a exportação.

Etapa 2: Criando RoleCapabilities

O arquivo RoleCapabilities decide o que uma função especificada (definida na próxima etapa) pode fazer. Isso inclui quais comandos eles têm permissão para executar, quais parâmetros eles podem usar e quais módulos importar.

Embora RoleCapabilities possa ser criado manualmente, é recomendável usar o New-PSRoleCapabilityFile comando incorporado no PowerShell 5.1. É também neste arquivo que você carrega a função que criamos na etapa anterior.

O script a seguir cria um arquivo chamado FileShareCreator.psrc e adiciona o New-FolderAndShare função (que precisa ser carregada na sessão atual):

# EXECUTE ISTO NO SERVIDOR QUE SERÁ O JEA ENDPOINT $ RoleCapabilitiesParam = @ {     # Defina uma função que estará disponível no cmdlet     FunctionDefinitions = @ {         Name = 'New-FolderAndShare'                 # Importe o código da função         ScriptBlock = (ScriptBlock) :: Create (             (Get-Command New-FolderAndShare) .Definição         )     }     # Os módulos usados ​​na função precisam ser importados explicitamente     ModulesToImport = @ (         "SmbShare",         "Microsoft.PowerShell.Management"     )     Caminho = ". FileShareCreator.psrc" } New-PSRoleCapabilityFile @RoleCapabilitiesParam

Utilizar Get-Command para buscar a função no FunctionDefinitions-parâmetro. Você também pode adicionar o script bruto com parâmetros.

Você também especifica como tem permissão para usar a função no VisibleCmdlet parâmetro. Você faz isso especificando o nome da função e seus parâmetros juntamente com uma expressão regular.

Com isso, você pode criar um controle extremamente granular do que um usuário pode ou não fazer. Mas há uma ressalva para fazer isso funcionar: você precisa adicionar o arquivo psrc em um módulo.

Etapa 3: Criando um módulo para o arquivo RoleCapability

Chegou a hora de criar um módulo no qual você pode colocar seus recursos de função. A JEA encontra os RoleCapabilities com o nome dos arquivos psrc sem sua extensão. Portanto, evite duplicatas se desejar criar mais recursos de função posteriormente.

O script a seguir é uma versão modificada do que você encontra no Documentação oficial da JEA. Ele cria um novo módulo no diretório do módulo, cria os arquivos e pastas necessários e copia o arquivo psrc arquivo que você criou na Etapa 2 para ele:

# EXECUTE ISTO NO SERVIDOR QUE SERÁ O JEA ENDPOINT # Crie uma pasta para o módulo $ modulePath = Caminho-da-junção $ env: ProgramFiles "WindowsPowerShell Modules FileShareJEA" Diretório New-Item -ItemType -Path $ modulePath # Crie um módulo de script vazio e um manifesto de módulo. # Pelo menos um arquivo na pasta do módulo deve ter o mesmo nome que a própria pasta. New-Item -ItemType File -Path (Caminho do caminho $ modulePath "FileShareJEA.psm1") New-ModuleManifest -Path (caminho de junção $ modulePath "FileShareJEA.psd1") -RootModule "FileShareJEA.psm1" # Crie a pasta RoleCapabilities e copie no arquivo PSRC $ rcFolder = Caminho do caminho $ modulePath "RoleCapabilities" Diretório New-Item -ItemType $ rcFolder Copy-Item -Path. FileShareCreator.psrc -Destination $ rcFolder

Agora você criou um recurso de função e uma função para poder usá-lo no JEA. O que resta agora é criar uma configuração de sessão do PowerShell para mapear grupos do AD para as funções que você acabou de criar.

Etapa 4: Definindo Funções

Nesta etapa, você criará um arquivo de configuração de sessão do PowerShell que define quais funções serão atribuídas a quais recursos (a partir de.psrc arquivo que criamos na Etapa 2).

Você também criará o grupo e o diretório de transcrição do AD aqui.

# Criar diretório para armazenar logs New-Item -ItemType Directory -Path 'C: ProgramData JEAConfiguration Transcripts' -Force # Criar grupo de anúncios (pode ser necessário em outro servidor) New-ADGroup -Path "OU = Grupos, DC = contoso, DC = com" -Nome 'JEA_FILESHARE_CREATOR' -GroupScope DomainLocal # EXECUTE ISTO NO SERVIDOR QUE SERÁ O JEA ENDPOINT # Defina parâmetros para New-PSSessionConfigurationFile $ PSSessionConfigurationParams = @ {     # Executar como uma conta temporária     RunAsVirtualAccount = $ True     # Esse é um administrador local     RunAsVirtualAccountGroups = @ (         "administradores"     )     # Caminho para salvar os arquivos de log do que os usuários conectados estão fazendo     TranscriptDirectory = 'C: ProgramData JEAConfiguration Transcripts'     # Mapear um grupo de diretório ativo para o recurso que criamos     RoleDefinitions = @ {         'CONTOSO JEA_FILESHARE_CREATOR' = @ {             RoleCapabilities = 'FileShareCreator'         }     }                  # Caminho do arquivo PSSC     Caminho = ". SessionConfiguration.pssc" } # Crie o arquivo PSSC New-PSSessionConfigurationFile @PSSessionConfigurationParams

Etapa 5: Criando uma sessão do PowerShell

Nesta etapa, você lerá o SessionConfiguration.pssc arquivo que você criou na etapa anterior. Isso permite que os membros de JEA_FILESHARE_CREATOR para se conectar via PowerShell ao servidor:

PS51> Register-PSSessionConfiguration -Path. SessionConfiguration.pssc -Nome 'JEAFileShare' -Force PSPath: Microsoft.WSMan.Management WSMan :: localhost Plugin JEAFileShare PSParentPath: Microsoft.WSMan.Management WSMan :: localhost Plugin PSChildName: JEAFileShare PSDrive: WSMan PSProvider: Microsoft.WSMan.Management WSMan PSIsContainer: True Chaves: {Name = JEAFileShare} Nome: JEAFileShare TypeNameOfElement: Container Tipo: Container

Você Terminou! Adicione um usuário a JEA_FILESHARE_CREATOR que não tem acesso ao servidor por meios normais e tente como esse usuário digitando:

PS51> Enter-PSSession -ComputerName fs02.contoso.com -ConfigurationName JEAFileShare PS51> New-FolderAndShare -ShareName "Projeto 12345" - Caminho D: Share 

Agora você pode executar o comando como administrador local temporário bloqueado e ativado apenas para executar alguns comandos padrão (visíveis com Get-Command durante a sessão) e o New-FolderAndShare função adicionada no arquivo de Recursos de Função.

Se você quiser ver a conta criada temporariamente, adicione VisibleExternalCommands @ ('c: windows system32 whoami.exe') aos seus parâmetros RoleCapabilities na Etapa 2. Você pode executar whoami e ver o nome do administrador local:

PS51> whoami usuários virtuais winrm winrm va_1_contoso_joe_helpdesk

Sumário

Usar o JEA pode ser uma maneira incrível e fácil de delegar tarefas e proteger seu ambiente. Isso não inclui apenas seus próprios scripts, mas também módulos internos e módulos instalados. Mesmo que o JEA possa ser um grande valor agregado, tenha cuidado! Você pode criar um grande risco para o seu ambiente se delegar os comandos errados ou especificar os parâmetros errados para indivíduos inesperados.

Deseja saber mais?

Adicione ao Google Notícias