Release 1.1.0 SailPoint IdentityNow PowerShell Module & Example Jupyter Notebook

I’ve just published v1.1.0 of the SailPoint IdentityNow PowerShell Module to both GitHub and the PowerShell Gallery. Release 1.1.0 of the SailPoint IdentityNow PowerShell Module is the result of considerable effort by myself and Sean McGovern. Release 1.1.0 is a major update comprising updates to all of the cmdlets, at least 5 new cmdlets, bug-fixes, documentation updates and removal of a cmdlet due to a deprecated API.

v1.0.7 to v1.1.0 Release Notes

Release 1.1.0 is the first to be Code Signed and includes;

  • an updated authentication process to send API credentials via POST
  • updated authentication methods to support Personal Access Tokens
  • New cmdlets to;
    • Get / Create / Remove Personal Access Tokens
      • Get-IdentityNowPersonalAccessToken
      • New-IdentityNowPersonalAccessToken
      • Remove-IdentityNowPersonalAccessToken
    • Update IdentityNow Profile Mapping
      • Update-IdentityNowProfileMapping
    • Get Schema from an IdentityNow Source
      • Get-IdentityNowSourceSchema
  • Updated cmdlets;
      • Invoke-IdentityNowRequest
        • supports -json option for API responses
      • Set IdentityNow Credential to support
        • Personal Access Token
        • JWT
      • Get-IdentityNowGovernanceGroup now uses the option -groupID the same as Remove-IdentityNowGovernanceGroup and Update-IdentityNowGovernanceGroup
        • if you have automations that use the Get-IdentityNowGovernanceGroup cmdlet with the -group parameter to return specific Governance Groups, you will need to update them to change -group to -groupID.
  • Removed cmdlet;
  • many documentation updates and fixes

SailPoint IdentityNow PowerShell Module Examples Jupyter Notebook

To coincide with the v1.1.0 release I’ve also produced a PowerShell Jupyter Notebook with examples of the syntax for the cmdlets contained in the module. If you are new to PowerShell Jupyter Notebooks, see this guide to get a local PowerShell Notebook environment configured.

With a local PowerShell Notebook environment configured obtain the IdentityNow PowerShell Module Examples Jupyter Notebook from my GIST (as imbedded below) and open it in your local PowerShell Jupyter Notebook environment.

Full list of cmdlets

Name                                        Synopsis                                                                                             
----                                        --------                                                                                             
Complete-IdentityNowTask                    Complete an IdentityNow Task.                                                                        
Convert-UnixTime                            Convert UnixTime to PowerShell DateTime                                                              
Get-HashString                              Generate IdentityNow Admin User Password Hash to obtain oAuth Access Token.                          
Get-IdentityNowAccessProfile                Get an IdentityNow Access Profile(s).                                                                
Get-IdentityNowAccountActivities            Get IdentityNow Activities.                                                                          
Get-IdentityNowAccountActivity              Get IdentityNow Activity for an account.                                                             
Get-IdentityNowActiveJobs                   Get IdentityNow Active Jobs.                                                                         
Get-IdentityNowAPIClient                    Get IdentityNow API Client(s).                                                                       
Get-IdentityNowApplication                  Get IdentityNow Application(s).                                                                      
Get-IdentityNowAuth                         Get IdentityNow JWT access token or basic auth header.                                               
Get-IdentityNowCertCampaign                 Get IdentityNow Certification Campaign(s).                                                           
Get-IdentityNowCertCampaignReport           Get IdentityNow Certification Campaign Report(s).                                                    
Get-IdentityNowEmailTemplate                Get IdentityNow Email Template(s).                                                                   
Get-IdentityNowGovernanceGroup              Get an IdentityNow Governance Group.                                                                 
Get-IdentityNowIdentityAttribute            Get an IdentityNow Identity Attribute(s).                                                            
Get-IdentityNowOAuthAPIClient               Get IdentityNow oAuth API Client(s).                                                                 
Get-IdentityNowOrg                          Displays the default Uri value for all or a particular Organisation based on configured OrgName.     
Get-IdentityNowOrgConfig                    Get IdentityNow Org Global Reminders and Escalation Policies Configuration.                          
Get-IdentityNowOrgStatus                    Get an IdentityNow Org Status.                                                                       
Get-IdentityNowPersonalAccessToken          List IdentityNow Personal Access Tokens.                                                             
Get-IdentityNowProfile                      Get IdentityNow Identity Profile(s).                                                                 
Get-IdentityNowProfileOrder                 Get IdentityNow Profiles Order.                                                                      
Get-IdentityNowQueue                        Get IdentityNow Queues.                                                                              
Get-IdentityNowRole                         Get an IdentityNow Role(s).                                                                          
Get-IdentityNowRule                         Get IdentityNow Rule(s).                                                                             
Get-IdentityNowSource                       Get IdentityNow Source(s).                                                                           
Get-IdentityNowSourceAccounts               Get IdentityNow Accounts on a Source.                                                                
Get-IdentityNowSourceSchema                 Get the Schema for an IdentityNow Source.                                                            
Get-IdentityNowTask                         Get an IdentityNow Task(s).                                                                          
Get-IdentityNowTimeZone                     Get IdentityNow Time Zone(s).                                                                        
Get-IdentityNowTransform                    Get IdentityNow Transform(s).                                                                        
Get-IdentityNowVACluster                    Get IdentityNow Virtual Appliance Cluster(s).                                                        
Invoke-IdentityNowAggregateSource           Initiate Aggregation of an IdentityNow Source.                                                       
Invoke-IdentityNowRequest                   Submit an IdentityNow API Request.                                                                   
Invoke-IdentityNowSourceReset               Reset an IdentityNow Source.                                                                         
Join-IdentityNowAccount                     Join an IdentityNow User Account to an Identity.                                                     
New-IdentityNowAccessProfile                Create an IdentityNow Access Profile.                                                                
New-IdentityNowAPIClient                    Create an IdentityNow v2 API Client.                                                                 
New-IdentityNowCertCampaign                 Create an IdentityNow Certification Campaign.                                                        
New-IdentityNowGovernanceGroup              Create a new IdentityNow Governance Group.                                                           
New-IdentityNowIdentityProfilesReport       Generate a HTML Report of IdentityNow Identity Profiles and export each Identity Profile config.     
New-IdentityNowOAuthAPIClient               Create an IdentityNow v3 oAuth API Client.                                                           
New-IdentityNowPersonalAccessToken          Create an IdentityNow Personal Access Token.                                                         
New-IdentityNowProfile                      Create new IdentityNow Identity Profile(s).                                                          
New-IdentityNowRole                         Create an IdentityNow Role.                                                                          
New-IdentityNowSource                       Create an IdentityNow Source.                                                                        
New-IdentityNowSourceAccountSchemaAttribute Discover or add to a sources' account schema.                                                        
New-IdentityNowSourceConfigReport           Generate a HTML Report of IdentityNow Sources configuration and export each Source and Schema config.
New-IdentityNowTransform                    Create an IdentityNow Transform.                                                                     
New-IdentityNowUserSourceAccount            Create an IdentityNow User Account on a Flat File Source.                                            
Remove-IdentityNowAccessProfile             Delete an IdentityNow Access Profile.                                                                
Remove-IdentityNowAPIClient                 Delete an IdentityNow API Client.                                                                    
Remove-IdentityNowGovernanceGroup           Delete an IdentityNow Governance Group.                                                              
Remove-IdentityNowOAuthAPIClient            Delete an IdentityNow oAuth API Client.                                                              
Remove-IdentityNowPersonalAccessToken       Delete a personal access token in IdentityNow.                                                       
Remove-IdentityNowProfile                   Delete an IdentityNow Identity Profile.                                                              
Remove-IdentityNowRole                      Delete an IdentityNow Role.                                                                          
Remove-IdentityNowSource                    Deletes an IdentityNow Source.                                                                       
Remove-IdentityNowTransform                 Delete an IdentityNow Transform.                                                                     
Remove-IdentityNowUserSourceAccount         Delete an IdentityNow User Account on a Flat File Source.                                            
Save-IdentityNowConfiguration               Saves default IdentityNow configuration to a file in the current users Profile.                      
Search-IdentityNowEntitlements              Get IdentityNow Entitlements.                                                                        
Search-IdentityNowEvents                    Search IdentityNow Event(s) using Elasticsearch queries.                                             
Search-IdentityNowIdentities                Search IdentityNow Identitie(s) using Elasticsearch queries.                                         
Search-IdentityNowUserProfile               Get an IdentityNow Users Identity Profile.                                                           
Search-IdentityNowUsers                     Get IdentityNow Users.                                                                               
Set-IdentityNowCredential                   Sets the default IdentityNow API credentials.                                                        
Set-IdentityNowOrg                          Sets the default Organisation name for an IdentityNow Tenant.                                        
Set-IdentityNowTimeZone                     Set IdentityNow Time Zone.                                                                           
Start-IdentityNowCertCampaign               Start an IdentityNow Certification Campaign that is currently 'Staged'.                              
Start-IdentityNowProfileUserRefresh         Triggers a user refresh for an IdentityNow Identity Profile(s).                                      
Test-IdentityNowCredentials                 Tests IdentityNow Live credentials.                                                                  
Test-IdentityNowSourceConnection            Tests connection on an IdentityNow Source.                                                           
Test-IdentityNowTransforms                  Test IdentityNow transforms to detect common problems                                                
Update-IdentityNowAccessProfile             Update an IdentityNow Access Profile(s).                                                             
Update-IdentityNowApplication               Update an IdentityNow Application.                                                                   
Update-IdentityNowEmailTemplate             Update an IdentityNow Email Template.                                                                
Update-IdentityNowGovernanceGroup           Add or Remove member(s) from an IdentityNow Governance Group.                                        
Update-IdentityNowIdentityAttribute         Update an IdentityNow Identity Attribute to be listed in Identity Profiles.                          
Update-IdentityNowOrgConfig                 Update IdentityNow Org Global Reminders and Escalation Policies Configuration.                       
Update-IdentityNowProfileMapping            Update IdentityNow Profile Attribute Mapping.                                                        
Update-IdentityNowProfileOrder              Update IdentityNow Profile Order.                                                                    
Update-IdentityNowRole                      Update an IdentityNow Role.                                                                          
Update-IdentityNowSource                    Update the configuration of an IdentityNow Source.                                                   
Update-IdentityNowTransform                 Update an IdentityNow Transform.                                                                     
Update-IdentityNowUserSourceAccount         Update an IdentityNow User Account on a Flat File Source.

Want to contribute?

  • Found an issue and want us to fix it? Log it
  • Want to fix an issue yourself or add functionality? Clone the project and submit a pull request.
  • Any and all contributions are more than welcome and appreciated.