JumpCloud

1.1.0

test/JumpCloud.1.1.0.Tests.ps1

                                #Tests for JumpCloud Module Version 1.0.0

# To run all the Pester Tests you will need to have a tenant that matches the below criteria.

# For Command Results Tests - Have at least 5 command results present in your Org

# For Commands Tests - Have at least 2 JumpCloud commands that are set to run via the 'Run on Trigger' event

# For Groups Tests - Have at least 2 JumpCloud User Groups and 2 JumpCloud System Groups

# For Systems Tests - Have at least 2 JumpCloud Systems present in your Org.

# For Users Tests - Have at least 2 JumpCloud Users present in your Org.

#Additionally you must populate the below variables to run successful tests using the -ByID parameter

$SystemID = '' # Enter the System ID for a system in your test tenant. **Note users will be added and removed from this system during the tests

$Username = 'pester.tester' # Create a user with username 'pester.tester'

$UserID = '' # Paste the UserID for the user with username pester.tester

$UserGroupName = 'PesterTest_UserGroup'  #Create a user group named PesterTest_UserGroup within your environment

$UserGroupID = ''  # Paste the corresponding GroupID for the user group named PesterTest_UserGroup

$SystemGroupName = 'PesterTest_SystemGroup' # Create a sytem group named PesterTest_SystemGroup within your environment

$SystemGroupID = ''  # Paste the corresponding GroupID for the sytem group named PesterTest_SystemGroup

$NewJCSystemGroup = 'NewSystemGroup' #Do not modify this

$NewJCUserGroup = 'NewUserGroup' #Do not modify this

$CSVPath = '' #Path to ImportExample_Pester_Tests_1.1.0.csv //REQUIRED update the system under 'SystemID' in the .CSV file

#Test Functions

Function New-RandomUser  ()

{

    [CmdletBinding(DefaultParameterSetName='NoAttributes')]

    param

    (

        [Parameter(Mandatory,Position=0)]

        [String]

        $Domain,

        [Parameter(ParameterSetName='Attributes')] ##Test this to see if this can be modified.

        [switch]

        $Attributes

    )

    if (($PSCmdlet.ParameterSetName -eq 'NoAttributes'))

    {

        $username = -join ((65..90) + (97..122) | Get-Random -Count 8 | ForEach-Object {[char]$_})

        $email =  $username + "@$Domain.com"

        $RandomUser = [ordered]@{

        FirstName = 'Pester'

        LastName = 'Test'

        Username = $username

        Email = $email

        Password = 'Temp123!'

        }

        $NewRandomUser =  New-Object psobject -Property $RandomUser

    }

    if (($PSCmdlet.ParameterSetName -eq 'Attributes'))

    {

        $username = -join ((65..90) + (97..122) | Get-Random -Count 8 | ForEach-Object {[char]$_})

        $email =  $username + "@$Domain.com"

        $RandomUser = [ordered]@{

        FirstName = 'Pester'

        LastName = 'Test'

        Username = $username

        Email = $email

        Password = 'Temp123!'

        NumberOfCustomAttributes = 3

        Attribute1_name = 'Department'

        Attribute1_value = 'Sales'

        Attribute2_name = 'Office'

        Attribute2_value = '456789'

        Attribute3_name = 'Lang'

        Attribute3_value = 'French'

        }

        $NewRandomUser =  New-Object psobject -Property $RandomUser

    }

    return $NewRandomUser

}

Function New-RandomString () {

    [CmdletBinding()]

    param(

    [Parameter(Mandatory)] ##Test this to see if this can be modified.

    [ValidateRange(0,52)]

    [Int]

    $NumberOfChars

    )

    begin {}

    process{

        $Random = -join ((65..90) + (97..122) | Get-Random -Count $NumberOfChars | % {[char]$_})

    }

    end{Return $Random}

}

$Random = New-RandomString '8'

$RandomEmail = "$Random@$Random.com"

Describe 'Set-JCSystemUser'{

    It "Sets a standard user to an admin user using username"{

        Add-JCSystemUser -SystemID $SystemID -Username $Username -Administrator $False #Sets to standard user

        $CommandResults = Set-JCSystemUser -SystemID $SystemID -Username $Username -Administrator $True

        $CommandResults.Administrator | Should -Be $True

        $GetSystem = Get-JCSystemUser -SystemID $SystemID | ? Username -EQ $Username | Select Administrator

        $GetSystem.Administrator | Should -Be $True

    }

    It "Sets an admin user to a standard user using username"{

        Set-JCSystemUser -SystemID $SystemID -Username $Username -Administrator $True #Sets to standard user

        $CommandResults = Set-JCSystemUser -SystemID $SystemID -Username $Username -Administrator $False

        $CommandResults.Administrator | Should -Be $False

        $GetSystem = Get-JCSystemUser -SystemID $SystemID | ? Username -EQ $Username | Select Administrator

        $GetSystem.Administrator | Should -Be $False

    }

    It "Sets a standard user to an admin user using UserID"{

        Set-JCSystemUser -SystemID $SystemID -UserID $UserID -Administrator $False #Sets to standard user

        $CommandResults = Set-JCSystemUser -SystemID $SystemID -UserID $UserID -Administrator $True

        $CommandResults.Administrator | Should -Be $True

        $GetSystem = Get-JCSystemUser -SystemID $SystemID | ? Username -EQ $Username | Select Administrator

        $GetSystem.Administrator | Should -Be $True

    }

    It "Sets an admin user to a standard user using UserID"{

        Set-JCSystemUser -SystemID $SystemID -UserID $UserID -Administrator $True #Sets to standard user

        $CommandResults = Set-JCSystemUser -SystemID $SystemID -UserID $UserID -Administrator $False

        $CommandResults.Administrator | Should -Be $False

        $GetSystem = Get-JCSystemUser -SystemID $SystemID | ? Username -EQ $Username | Select Administrator

        $GetSystem.Administrator | Should -Be $False

    }

}

Describe 'Add-JCSystemUser 1.1.0 and Get-JCSystemUser 1.1.0' {

    IT "Adds a JumpCloud User to a JumpCloud System with admin `$False using username"{

        $User = New-RandomUserCustom -Domain 'pleasedelete' | New-JCUser

        $FalseUser = Add-JCSystemUser -Username $User.username -SystemID $SystemID -Administrator $False

        $FalseUser.Administrator | Should Be $False

        $GetUser = Get-JCSystemUser -SystemID $SystemID | ? Username -EQ $FalseUser.Username | Select-Object Administrator

        $GetUser.Administrator | Should Be $False

    }

    IT "Adds a JumpCloud User to a JumpCloud System with admin $False using username"{

        $User = New-RandomUserCustom -Domain 'pleasedelete' | New-JCUser

        $FalseUser = Add-JCSystemUser -Username $User.username -SystemID $SystemID -Administrator $False

        $FalseUser.Administrator | Should Be $False

        $GetUser = Get-JCSystemUser -SystemID $SystemID | ? Username -EQ $FalseUser.Username | Select-Object Administrator

        $GetUser.Administrator | Should Be $False

    }

    IT "Adds a JumpCloud User to a JumpCloud System with admin `$False using UserID"{

        $User = New-RandomUserCustom -Domain 'pleasedelete' | New-JCUser

        $FalseUser = Add-JCSystemUser -UserID $User._id -SystemID $SystemID -Administrator $False

        $FalseUser.Administrator | Should Be $False

        $GetUser = Get-JCSystemUser -SystemID $SystemID | ? Username -EQ $User.Username | Select-Object Administrator

        $GetUser.Administrator | Should Be $False

    }

    IT "Adds a JumpCloud User to a JumpCloud System with admin `$True using UserID"{

        $User = New-RandomUserCustom -Domain 'pleasedelete' | New-JCUser

        $TrueUser = Add-JCSystemUser -UserID $User._id -SystemID $SystemID -Administrator $True

        $TrueUser.Administrator | Should Be $True

        $GetUser = Get-JCSystemUser -SystemID $SystemID | ? Username -EQ $User.Username | Select-Object Administrator

        $GetUser.Administrator | Should Be $True

    }

    IT "Adds a JumpCloud User to a JumpCloud System with admin $True using username"{

        $User = New-RandomUserCustom -Domain 'pleasedelete' | New-JCUser

        $TrueUser = Add-JCSystemUser -Username $User.username -SystemID $SystemID -Administrator $True

        $TrueUser.Administrator | Should Be $True

        $GetUser = Get-JCSystemUser -SystemID $SystemID | ? Username -EQ $TrueUser.Username | Select-Object Administrator

        $GetUser.Administrator | Should Be $True

    }

} 

Describe 'Get-JCGroup 1.1.0'{

    It "Gets a JumpCloud UserGroup by Name and Displays Attributes"{

        $Posix = Get-JCGroup -Type User -Name $UserGroupName

        $Posix.posixGroups.id | Should -Not -BeNullOrEmpty

        $Posix.posixGroups.name | Should -Not -BeNullOrEmpty

    }

}

Describe 'Import-JCUserFromCSV'{

    IT "Imports users from the ImportExample_Pester_Test using -Force" {

        $UserImport = Import-JCUsersFromCSV -CSVFilePath  $CSVpath -force

    }

    IT "Verifies a.user user" {

       $User =  Get-JCUser -Username 'a.user'

       $User.activated | Should be $True 

    }

    IT "Verifies ia.user user" {

        $User =  Get-JCUser -Username 'ia.user'

        $User.activated | Should be $False

     }

     IT "Verifies a.bound.std user" {

        $User =  Get-JCUser -Username 'a.bound.std'

        $User.activated | Should be $True

        $Bound = Get-JCSystemUser -SystemID $SystemID | ? username -EQ 'a.bound.std'

        $Bound.DirectBind | Should Be $True

        $Bound.Administrator | Should Be $False

     }

     IT "Verifies a.bound.true1 user" {

        $User =  Get-JCUser -Username 'a.bound.true1'

        $User.activated | Should be $True

        $Bound = Get-JCSystemUser -SystemID $SystemID | ? username -EQ 'a.bound.true1'

        $Bound.DirectBind | Should Be $True

        $Bound.Administrator | Should Be $True

     }

     IT "Verifies a.bound.false1 user" {

        $User =  Get-JCUser -Username 'a.bound.false1'

        $User.activated | Should be $True

        $Bound = Get-JCSystemUser -SystemID $SystemID | ? username -EQ 'a.bound.false1'

        $Bound.DirectBind | Should Be $True

        $Bound.Administrator | Should Be $False

     }

     IT "Verifies a.bound.true2 user" {

        $User =  Get-JCUser -Username 'a.bound.true2'

        $User.activated | Should be $True

        $Bound = Get-JCSystemUser -SystemID $SystemID | ? username -EQ 'a.bound.true2'

        $Bound.DirectBind | Should Be $True

        $Bound.Administrator | Should Be $True

     }

     IT "Verifies a.bound.false2 user" {

        $User =  Get-JCUser -Username 'a.bound.false2'

        $User.activated | Should be $True

        $Bound = Get-JCSystemUser -SystemID $SystemID | ? username -EQ 'a.bound.false2'

        $Bound.DirectBind | Should Be $True

        $Bound.Administrator | Should Be $False

     }

     IT "Verifies ia.bound.std user" {

        $User =  Get-JCUser -Username 'ia.bound.std'

        $User.activated | Should be $False

        $Bound = Get-JCSystemUser -SystemID $SystemID | ? username -EQ 'ia.bound.std'

        $Bound.DirectBind | Should Be $True

        $Bound.Administrator | Should Be $False

     }

     IT "Verifies ia.bound.true1 user" {

        $User =  Get-JCUser -Username 'ia.bound.true1'

        $User.activated | Should be $False

        $Bound = Get-JCSystemUser -SystemID $SystemID | ? username -EQ 'ia.bound.true1'

        $Bound.DirectBind | Should Be $True

        $Bound.Administrator | Should Be $True

     }

     IT "Verifies ia.bound.false1 user" {

        $User =  Get-JCUser -Username 'ia.bound.false1'

        $User.activated | Should be $False

        $Bound = Get-JCSystemUser -SystemID $SystemID | ? username -EQ 'ia.bound.false1'

        $Bound.DirectBind | Should Be $True

        $Bound.Administrator | Should Be $False

     }

     IT "Verifies ia.bound.true2 user" {

        $User =  Get-JCUser -Username 'ia.bound.true2'

        $User.activated | Should be $False

        $Bound = Get-JCSystemUser -SystemID $SystemID | ? username -EQ 'ia.bound.true2'

        $Bound.DirectBind | Should Be $True

        $Bound.Administrator | Should Be $True

     }

     IT "Verifies ia.bound.false2 user" {

        $User =  Get-JCUser -Username 'ia.bound.false2'

        $User.activated | Should be $False

        $Bound = Get-JCSystemUser -SystemID $SystemID | ? username -EQ 'ia.bound.false2'

        $Bound.DirectBind | Should Be $True

        $Bound.Administrator | Should Be $False

     }

     IT "Verifies a.1group user" {

        $User =  Get-JCUser -Username 'a.1group'

        $User.activated | Should be $True

        $Groups = Get-JCGroup -Type User | Get-JCUserGroupMember | ? Username -EQ 'a.1group'

        $Groups.GroupName.count | Should Be 1

     }

     IT "Verifies ia.1group user" {

        $User =  Get-JCUser -Username 'ia.1group'

        $User.activated | Should be $False

        $Groups = Get-JCGroup -Type User | Get-JCUserGroupMember | ? Username -EQ 'ia.1group'

        $Groups.GroupName.count | Should Be 1

     }

     IT "Verifies a.2group user" {

        $User =  Get-JCUser -Username 'a.2group'

        $User.activated | Should be $True

        $Groups = Get-JCGroup -Type User | Get-JCUserGroupMember | ? Username -EQ 'a.2group'

        $Groups.count | Should Be 2

     }

     IT "Verifies ia.2group user" {

        $User =  Get-JCUser -Username 'ia.2group'

        $User.activated | Should be $False

        $Groups = Get-JCGroup -Type User | Get-JCUserGroupMember | ? Username -EQ 'ia.2group'

        $Groups.count | Should Be 2

     }

     IT "Verifies a.2group user" {

        $User =  Get-JCUser -Username 'a.2group'

        $User.activated | Should be $True

        $Groups = Get-JCGroup -Type User | Get-JCUserGroupMember | ? Username -EQ 'a.2group'

        $Groups.count | Should Be 2

     }

     IT "Verifies ia.2group user" {

        $User =  Get-JCUser -Username 'ia.2group'

        $User.activated | Should be $False

        $Groups = Get-JCGroup -Type User | Get-JCUserGroupMember | ? Username -EQ 'ia.2group'

        $Groups.count | Should Be 2

     }

     IT "Verifies a.5group user" {

        $User =  Get-JCUser -Username 'a.5group'

        $User.activated | Should be $True

        $Groups = Get-JCGroup -Type User | Get-JCUserGroupMember | ? Username -EQ 'a.5group'

        $Groups.count | Should Be 5

     }

     IT "Verifies ia.5group user" {

        $User =  Get-JCUser -Username 'ia.5group'

        $User.activated | Should be $False

        $Groups = Get-JCGroup -Type User | Get-JCUserGroupMember | ? Username -EQ 'ia.5group'

        $Groups.count | Should Be 5

     }

     IT "Verifies a.1attr user" {

        $User =  Get-JCUser -Username 'a.1attr'

        $User.activated | Should be $True

        $User.attributes._id.count | Should Be 1

     }

     IT "Verifies ia.1attr user" {

        $User =  Get-JCUser -Username 'ia.1attr'

        $User.activated | Should be $False

        $attrs = 

        $User.attributes._id.count | Should Be 1

     }

     IT "Verifies a.2attr user" {

        $User =  Get-JCUser -Username 'a.2attr'

        $User.activated | Should be $True

        $User.attributes._id.count | Should Be 2

     }

     IT "Verifies ia.2attr user" {

        $User =  Get-JCUser -Username 'ia.2attr'

        $User.activated | Should be $False

        $attrs = 

        $User.attributes._id.count | Should Be 2

     }

     IT "Verifies a.5attr user" {

        $User =  Get-JCUser -Username 'a.5attr'

        $User.activated | Should be $True

        $User.attributes._id.count | Should Be 5

     }

     IT "Verifies ia.5attr user" {

        $User =  Get-JCUser -Username 'ia.5attr'

        $User.activated | Should be $False

        $attrs = 

        $User.attributes._id.count | Should Be 5

     }

     IT "Verifies a.all" {

        $User =  Get-JCUser -Username 'a.all'

        $User.activated | Should be $True

        $User.attributes._id.count | Should Be 5

        $Groups = Get-JCGroup -Type User | Get-JCUserGroupMember | ? Username -EQ 'a.all'

        $Groups.count | Should Be 5

        $Bound = Get-JCSystemUser -SystemID $SystemID | ? username -EQ 'a.all'

        $Bound.DirectBind | Should Be $True

        $Bound.Administrator | Should Be $True

     }

     IT "Verifies ia.all" {

        $User =  Get-JCUser -Username 'ia.all'

        $User.activated | Should be $False

        $User.attributes._id.count | Should Be 5

        $Groups = Get-JCGroup -Type User | Get-JCUserGroupMember | ? Username -EQ 'ia.all'

        $Groups.count | Should Be 5

        $Bound = Get-JCSystemUser -SystemID $SystemID | ? username -EQ 'ia.all'

        $Bound.DirectBind | Should Be $True

        $Bound.Administrator | Should Be $True

    }

}

# Cleans up newly created users from CSV import by deleteing them

Get-JCUser | ? Email -like *pleasedelete* | Remove-JCUser -force