Public/CP_EntraID.ps1
|
function New-CP365App { [CmdletBinding( SupportsShouldProcess = $true, ConfirmImpact = 'Medium' )] param( [Parameter(Mandatory)] [string]$domain, [Parameter(Mandatory)] [string]$GroupId ) begin { if (!(Test-SC365EntraConnStatus)) { throw [System.Exception] "You're not connected to Exchange Online - please connect prior to using Connect-MGGraph" } } process { $app = $null try { $appParameters = @{ DisplayName = 'Cyberpilot App' SignInAudience = 'AzureADMyOrg' } Write-Verbose "Creating app registration '$($appParameters.DisplayName)'" $app = New-MgApplication @appParameters -ErrorAction Stop Write-Verbose "Setting Cyberpilot Logo as the application logo for '$($app.DisplayName)'" $visualsPath = Join-Path (Split-Path -Parent $PSScriptRoot) 'Visuals' $logoPath = (Resolve-Path (Join-Path $visualsPath 'Cyberpilot.png') -ErrorAction Stop).Path if (-not (Test-Path $logoPath -PathType Leaf)) { throw "Application logo was not found: $logoPath" } Set-MgApplicationLogo -ApplicationId $app.Id -InFile $logoPath -ErrorAction Stop | Out-Null Write-Verbose "Reading Microsoft Graph service principal" $graphAppId = '00000003-0000-0000-c000-000000000000' $graphServicePrincipal = Get-MgServicePrincipal ` -Filter "appId eq '$graphAppId'" ` -Property 'id,appId,appRoles' ` -ErrorAction Stop if (-not $graphServicePrincipal.Id) { throw 'The Microsoft Graph service principal was not found in this tenant.' } $permissionNames = @('User.Read.All', 'Group.ReadWrite.All') $permissions = foreach ($permissionName in $permissionNames) { $permission = $graphServicePrincipal.AppRoles | Where-Object { $_.Value -eq $permissionName -and $_.IsEnabled -and 'Application' -in $_.AllowedMemberTypes } if (-not $permission) { throw "Microsoft Graph application permission '$permissionName' was not found." } @{ Id = $permission.Id Type = 'Role' } } $requiredResourceAccess = @( @{ ResourceAppId = $graphAppId ResourceAccess = @($permissions) } ) Update-MgApplication -ApplicationId $app.Id -RequiredResourceAccess $requiredResourceAccess -ErrorAction Stop | Out-Null $servicePrincipalParameters = @{ DisplayName = $app.DisplayName AppId = $app.AppId Tags = @('WindowsAzureActiveDirectoryIntegratedApp', 'HideApp') } Write-Verbose "Creating service principal for app '$($app.AppId)'" $servicePrincipal = New-MgServicePrincipal @servicePrincipalParameters -ErrorAction Stop foreach ($permission in $permissions) { Write-Verbose "Granting Microsoft Graph application role '$($permission.Id)' to service principal '$($servicePrincipal.Id)'" New-MgServicePrincipalAppRoleAssignedTo ` -ServicePrincipalId $graphServicePrincipal.Id ` -BodyParameter @{ principalId = $servicePrincipal.Id resourceId = $graphServicePrincipal.Id appRoleId = $permission.Id } ` -ErrorAction Stop | Out-Null } Write-Verbose "Linking Group with ID $groupId to APP '$($app.DisplayName)'" New-MgServicePrincipalAppRoleAssignedTo ` -ServicePrincipalId $servicePrincipal.Id ` -BodyParameter @{ principalId = $GroupId resourceId = $servicePrincipal.Id appRoleId = '00000000-0000-0000-0000-000000000000' } ` -ErrorAction Stop | Out-Null Write-Verbose "Creating client secret for app '$($app.DisplayName)'" $secretStart = [DateTimeOffset]::UtcNow $secretEnd = $secretStart.AddMonths(24) $clientSecret = Add-MgApplicationPassword ` -ApplicationId $app.Id ` -BodyParameter @{ passwordCredential = @{ displayName = 'Cyberpilot Client Secret' startDateTime = $secretStart endDateTime = $secretEnd } } ` -ErrorAction Stop if ([string]::IsNullOrWhiteSpace($clientSecret.SecretText)) { throw 'Microsoft Graph did not return a client secret value.' } $secretId = $clientSecret.KeyId Write-Warning "Client secret for Secret ID $secretId is displayed below. Store securely; !!! It will be shown only once !!!" Write-Output "$($clientSecret.SecretText)" $clientSecret = $null Write-Verbose "Created app '$($app.AppId)' and assigned it to group '$GroupId'" [pscustomobject]@{ 'Enterpris App DisplayName' = $servicePrincipal.DisplayName 'Enterprise App ObjectId' = $servicePrincipal.Id 'Application DisplayName' = $app.DisplayName 'Application Id' = $app.Id 'App created Datetime' = $app.CreatedDateTime 'Application ClientId' = $app.AppId 'App Secret Id' = $secretId 'App Secret Expires' = $secretEnd } } catch { if ($app) { Write-Warning "Provisioning failed; app registration '$($app.Id)' may be only partially configured." } throw } } end { } } # SIG # Begin signature block # MIIQVQYJKoZIhvcNAQcCoIIQRjCCEEICAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDUogYJIaPre6Op # 6ElPTXOWlKnjInHHOmz7wWWKZDh9IqCCDJEwggYaMIIEAqADAgECAhBiHW0MUgGe # O5B5FSCJIRwKMA0GCSqGSIb3DQEBDAUAMFYxCzAJBgNVBAYTAkdCMRgwFgYDVQQK # Ew9TZWN0aWdvIExpbWl0ZWQxLTArBgNVBAMTJFNlY3RpZ28gUHVibGljIENvZGUg # U2lnbmluZyBSb290IFI0NjAeFw0yMTAzMjIwMDAwMDBaFw0zNjAzMjEyMzU5NTla # MFQxCzAJBgNVBAYTAkdCMRgwFgYDVQQKEw9TZWN0aWdvIExpbWl0ZWQxKzApBgNV # BAMTIlNlY3RpZ28gUHVibGljIENvZGUgU2lnbmluZyBDQSBSMzYwggGiMA0GCSqG # SIb3DQEBAQUAA4IBjwAwggGKAoIBgQCbK51T+jU/jmAGQ2rAz/V/9shTUxjIztNs # fvxYB5UXeWUzCxEeAEZGbEN4QMgCsJLZUKhWThj/yPqy0iSZhXkZ6Pg2A2NVDgFi # gOMYzB2OKhdqfWGVoYW3haT29PSTahYkwmMv0b/83nbeECbiMXhSOtbam+/36F09 # fy1tsB8je/RV0mIk8XL/tfCK6cPuYHE215wzrK0h1SWHTxPbPuYkRdkP05ZwmRmT # nAO5/arnY83jeNzhP06ShdnRqtZlV59+8yv+KIhE5ILMqgOZYAENHNX9SJDm+qxp # 4VqpB3MV/h53yl41aHU5pledi9lCBbH9JeIkNFICiVHNkRmq4TpxtwfvjsUedyz8 # rNyfQJy/aOs5b4s+ac7IH60B+Ja7TVM+EKv1WuTGwcLmoU3FpOFMbmPj8pz44MPZ # 1f9+YEQIQty/NQd/2yGgW+ufflcZ/ZE9o1M7a5Jnqf2i2/uMSWymR8r2oQBMdlyh # 2n5HirY4jKnFH/9gRvd+QOfdRrJZb1sCAwEAAaOCAWQwggFgMB8GA1UdIwQYMBaA # FDLrkpr/NZZILyhAQnAgNpFcF4XmMB0GA1UdDgQWBBQPKssghyi47G9IritUpimq # F6TNDDAOBgNVHQ8BAf8EBAMCAYYwEgYDVR0TAQH/BAgwBgEB/wIBADATBgNVHSUE # DDAKBggrBgEFBQcDAzAbBgNVHSAEFDASMAYGBFUdIAAwCAYGZ4EMAQQBMEsGA1Ud # HwREMEIwQKA+oDyGOmh0dHA6Ly9jcmwuc2VjdGlnby5jb20vU2VjdGlnb1B1Ymxp # Y0NvZGVTaWduaW5nUm9vdFI0Ni5jcmwwewYIKwYBBQUHAQEEbzBtMEYGCCsGAQUF # BzAChjpodHRwOi8vY3J0LnNlY3RpZ28uY29tL1NlY3RpZ29QdWJsaWNDb2RlU2ln # bmluZ1Jvb3RSNDYucDdjMCMGCCsGAQUFBzABhhdodHRwOi8vb2NzcC5zZWN0aWdv # LmNvbTANBgkqhkiG9w0BAQwFAAOCAgEABv+C4XdjNm57oRUgmxP/BP6YdURhw1aV # cdGRP4Wh60BAscjW4HL9hcpkOTz5jUug2oeunbYAowbFC2AKK+cMcXIBD0ZdOaWT # syNyBBsMLHqafvIhrCymlaS98+QpoBCyKppP0OcxYEdU0hpsaqBBIZOtBajjcw5+ # w/KeFvPYfLF/ldYpmlG+vd0xqlqd099iChnyIMvY5HexjO2AmtsbpVn0OhNcWbWD # RF/3sBp6fWXhz7DcML4iTAWS+MVXeNLj1lJziVKEoroGs9Mlizg0bUMbOalOhOfC # ipnx8CaLZeVme5yELg09Jlo8BMe80jO37PU8ejfkP9/uPak7VLwELKxAMcJszkye # iaerlphwoKx1uHRzNyE6bxuSKcutisqmKL5OTunAvtONEoteSiabkPVSZ2z76mKn # zAfZxCl/3dq3dUNw4rg3sTCggkHSRqTqlLMS7gjrhTqBmzu1L90Y1KWN/Y5JKdGv # spbOrTfOXyXvmPL6E52z1NZJ6ctuMFBQZH3pwWvqURR8AgQdULUvrxjUYbHHj95E # jza63zdrEcxWLDX6xWls/GDnVNueKjWUH3fTv1Y8Wdho698YADR7TNx8X8z2Bev6 # SivBBOHY+uqiirZtg0y9ShQoPzmCcn63Syatatvx157YK9hlcPmVoa1oDE5/L9Uo # 2bC5a4CH2RwwggZvMIIE16ADAgECAhBIqMP3CCLHOHtOKuaWNyeFMA0GCSqGSIb3 # DQEBDAUAMFQxCzAJBgNVBAYTAkdCMRgwFgYDVQQKEw9TZWN0aWdvIExpbWl0ZWQx # KzApBgNVBAMTIlNlY3RpZ28gUHVibGljIENvZGUgU2lnbmluZyBDQSBSMzYwHhcN # MjYwNDE1MDAwMDAwWhcNMjcwNzE0MjM1OTU5WjBmMQswCQYDVQQGEwJERTEPMA0G # A1UECAwGQmF5ZXJuMSIwIAYDVQQKDBlTRVBQbWFpbCBEZXV0c2NobGFuZCBHbWJI # MSIwIAYDVQQDDBlTRVBQbWFpbCBEZXV0c2NobGFuZCBHbWJIMIICIjANBgkqhkiG # 9w0BAQEFAAOCAg8AMIICCgKCAgEAvAFzE8MbJpvQt+IdIh1M+bKYsJBFDk4b9ySe # 25IrCi00B9o5XmQtIw42MqyIKbUq1tDARtp9KTQedEP9W+rflAF2l+0Z046Jkiqu # mU9/enbqWLDyln1aS/p7HOgwZFMhnsR9zH0MfFckiklUmkzJO+vmzYAK7ZmDxajN # LJs0gkGRU2/BecAx/TSvLXMaKONsKZCyMKQCnwo1mCY/tFl5EgUz7YQFrPORBQGf # Qke/hkdBfQDqNRsi/J6+KhJWc6LvgQihdRg/INQbQsTxlow18NWvyFsjjueH7kG6 # HR4YKfbv07xgrsIh8xvq9ZJ1SBhLXmkg4SdoQGASjqR6o3keAX+bDRFf+hmlWWJp # /FqVHR5QomF3vbK2/bbz4jAclYSPx/sPasNJ0YnKFkgmowZ7Ysa0KA0/egBgtI4g # J+8V7zrqIVEG3rMQh9KCdMnJqP2aM9o4gUzQvE1M4x606liX9EWwdLLS+fe79o+F # zo5oH4wBE/En6hQQkzseHHu+TXCDd6zUUZ/PlTK0gTaDIRXt6UzPNqJ4RiRCW2pN # FcPt078qqVTuwKUXoE4ufxGgXKFrZlCYST/9eG1TnW2oq19nz8A333GCsL3gpoNI # KvfmDyGMMNzvx2aeqn2v6e75z8kH19iGSNZ51xT+WgS9F1aIvjz08/T7XAv7iDPF # 1/gPIp8CAwEAAaOCAakwggGlMB8GA1UdIwQYMBaAFA8qyyCHKLjsb0iuK1SmKaoX # pM0MMB0GA1UdDgQWBBS30/Tq+alF3j2BY5up8n5zpAU23DAOBgNVHQ8BAf8EBAMC # B4AwDAYDVR0TAQH/BAIwADATBgNVHSUEDDAKBggrBgEFBQcDAzBKBgNVHSAEQzBB # MDUGDCsGAQQBsjEBAgEDAjAlMCMGCCsGAQUFBwIBFhdodHRwczovL3NlY3RpZ28u # Y29tL0NQUzAIBgZngQwBBAEwSQYDVR0fBEIwQDA+oDygOoY4aHR0cDovL2NybC5z # ZWN0aWdvLmNvbS9TZWN0aWdvUHVibGljQ29kZVNpZ25pbmdDQVIzNi5jcmwweQYI # KwYBBQUHAQEEbTBrMEQGCCsGAQUFBzAChjhodHRwOi8vY3J0LnNlY3RpZ28uY29t # L1NlY3RpZ29QdWJsaWNDb2RlU2lnbmluZ0NBUjM2LmNydDAjBggrBgEFBQcwAYYX # aHR0cDovL29jc3Auc2VjdGlnby5jb20wHgYDVR0RBBcwFYETc3VwcG9ydEBzZXBw # bWFpbC5jaDANBgkqhkiG9w0BAQwFAAOCAYEAi7fmb5UYoemWG3CC4K2UZWVrR6GO # fi8gbJKgjPbKO4zrCrU/x6cOdyp6scKZfUEGFDf8KH6pP4pAQv1Hsbi49gU2kxoU # WLlCiipn05qJY663DHx9hlStej/ZdEatou0wyCDiG5xD7kmG+1t6iLyyCBgEB88t # JpzTjI61qXmBTS/FGEOAsB4SDEW1ngA7bc5FOv4IUKA43hp8M+N3GeYFzDqwJELY # EfVVYheBW3o7q4VrCdfFEuaQihOtvfDfYpP6ANgekNn8HdsMT8rx9D1I50Rli/qQ # Fo2BOuPyb2SIQPzJvCs5wgi5qgp1nHiN6igumu2Cz7BmGjOazGUgCSUY5QwyE8+F # +R2tVM+2O15rfX01+e56ZfojBEiEjMwfPHs3fa3V3gokWWNwUMkton/v0R/nl2zj # mOr2okohOINZEDh9frg21zUCN5ZD8Y4zQWuiJLCvvvBZs0JR4c9xl2k2wtw/QLPh # GU69zM3smGpRoLE8M6zvUvSU7jXjvefazUniMYIDGjCCAxYCAQEwaDBUMQswCQYD # VQQGEwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMSswKQYDVQQDEyJTZWN0 # aWdvIFB1YmxpYyBDb2RlIFNpZ25pbmcgQ0EgUjM2AhBIqMP3CCLHOHtOKuaWNyeF # MA0GCWCGSAFlAwQCAQUAoIGEMBgGCisGAQQBgjcCAQwxCjAIoAKAAKECgAAwGQYJ # KoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEOMAwGCisGAQQB # gjcCARUwLwYJKoZIhvcNAQkEMSIEINI56gRUJ5n+o4GjzaVARsew/9hHHSMsyoFY # pUcAdZ8AMA0GCSqGSIb3DQEBAQUABIICAHPm/5h9nWYOSTSCygvPAiYHxstGJrBF # +oeFjfYsr82vbsR06lPF5mIi6bVYjVeykPkOzZw9tlpEFHD7ywrCG2jQY7FlApRT # Ps/8H8KqoOcwn9+Iob/Zns3hSvSkXHfWF5O3aTjl+3LB1YPcRM1532VAaZaKtVtW # 5QDOeXhfzoJvHKIiZEyHUhP4PMhejjup/HZjQnRk3WjP839RyIkstl986SQHawW2 # HGM/8YsUw17MtEttLvqYLTpy91NLm7106pN1MOwSyXPCZs/kL1+UMgv8zSWbFFbY # 3V1O/4n6HpG2X3Kr/jto91QBPN0xJggFaxGvRVnxc4gdB9qxvvThRk+mefZLti60 # fObErPO/jDgdMCxBc9ZXIfm6K52PCYw8z/jyCLpQQSuRwWcoojNhc+CREPJ82Ys/ # MM5nOaGSh8sD2JtP8OooGnsRi8tV9SUCqDtGo4m28m2kLYgNK8NyuEXS1cfrEPP+ # vc1Xzqt5HholTbQ3klpMnTrIFfKpx6uhqY9aT9Kpwg/Tqaxstd802WREl4UuPNg/ # IzwSvLXQ2HM/Ow304rSckoqAYlSYqO+Tsg73gbzHJYUDVITSfLZaMiyk71NvfkBI # V2Pbhc/R8pxhb/AtJ9fjXq4M70DbEU47J1vWyn2Q/fZvGQHv6YsZUaabOcVOQrmi # 1b6HX17VC37a # SIG # End signature block |