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