Skip to content

OneIdentity/safeguard-ps

Repository files navigation

PowerShell Gallery Docker Hub GitHub

safeguard-ps

One Identity Safeguard Powershell module and scripting resources.


Check out our samples to get started scripting to Safeguard!


Support

One Identity open source projects are supported through One Identity GitHub issues and the One Identity Community. This includes all scripts, plugins, SDKs, modules, code snippets or other solutions. For assistance with any One Identity GitHub project, please raise a new Issue on the One Identity GitHub project page. You may also visit the One Identity Community to ask questions. Requests for assistance made through official One Identity Support will be referred back to GitHub and the One Identity Community forums where those requests can benefit all users.

Default API Update

safeguard-ps will use v4 API by default starting with version 7.0. It is possible to continue using the v3 API by passing in the -Version parameter when creating a connection or calling A2A. There is also a new cmdlet Switch-SafeguardConnectionVersion for changing API version after connection.

Safeguard for Privileged Passwords 7.X hosts both the v3 and v4 APIs. New coding projects should target the v4 API, and existing projects can be migrated over time. Notification will be given to customers many releases in advance of any plans to remove the v3 API. There are currently no plans to remove the v3 API.

# Use v3 instead of v4 when connecting
# Existing scripts can be updated to work with safeguard-ps 7.0 just by adding -Version 3
# to the Connect-Safeguard command line.
> Connect-Safeguard 192.168.123.123 local Admin -Pkce -Version 3
Password: *********
Login Successful.
# All subsequent commands will use v3, use -Verbose for any cmdlet to see URL details

# Override version for Invoke-SafeguardMethod and A2A cmdlets
# Most cmdlets don't allow a Version parameter, but the generic invoke method and A2A cmdlets do.
> Invoke-SafeguardMethod Core GET Users -Version 3
> Get-SafeguardA2aPassword 192.168.123.123 -Version 3 -Thumbprint 42F9C3D01608604DB7065B86F306BED1D396B90B -ApiKey MP03DQ3hOCYZeOgCGXGQ1Cilwf1S8QYbdWvg2O7i14A=

# You can switch API versions after connection using this cmdlet
> Switch-SafeguardConnectionVersion -Version 3
# Then, switch back
> Switch-SafeguardConnectionVersion

Installation

This Powershell module is published to the PowerShell Gallery to make it as easy as possible to install using the built-in Import-Module cmdlet. It can also be updated using the Update-Module to get the latest functionality.

By default Powershell modules are installed for all users, and you need to be running Powershell as an Administrator to install for all users.

> Install-Module safeguard-ps

Or, you can install them just for you using the -Scope parameter which will never require Administrator permission:

> Install-Module safeguard-ps -Scope CurrentUser

Or you may need to use the new method:

> Install-PSResource -Name safeguard-ps

Note, Install-PSResource doesn't load the newly installed module into the current session. You must import the new version or start a new session to use the updated module.

Upgrading

If you want to upgrade from the PowerShell Gallery you should use:

> Update-Module safeguard-ps

Or, for a specific user:

> Update-Module safeguard-ps -Scope CurrentUser

If you run into errors while upgrading make sure that you upgrade for all users if the module was originally installed for all users. If the module was originally installed for just the current user, be sure to use the -Scope parameter to again specify CurrentUser when running the Update-Module cmdlet.

Prerelease Versions

To install a pre-release version of safeguard-ps you need to use the latest version of PowerShellGet if you aren't already. Windows comes with one installed, but you want the newest and it requires the -Force parameter to get it.

If you don't have PowerShellGet, run:

> Install-Module PowerShellGet -Force

Restart your Powershell shell. Then, you can install a pre-release version of safeguard-ps by running:

> Install-Module -Name safeguard-ps -AllowPrerelease

Getting Started

Once you have loaded the module, you can connect to Safeguard using the Connect-Safeguard cmdlet. If you do not have SSL properly configured, you must use the -Insecure parameter to avoid SSL trust errors.

Authentication in Safeguard is based on OAuth2. Starting with recent versions of Safeguard for Privileged Passwords, the Resource Owner Grant (ROG) is disabled by default. This means the traditional username/password login requires the -Pkce parameter to use the Proof Key for Code Exchange (PKCE) flow instead.

The recommended way to connect with a username and password is:

> Connect-Safeguard -Insecure 192.168.123.123 local Admin -Pkce
Password: ********
Login Successful.

Alternatively, you can use the -Browser parameter for a fully interactive browser-based login. This is the best option when using two-factor authentication or external identity providers, as the built-in secure token service can redirect you to multiple authentication providers through the browser agent. This authentication mechanism uses the Authorization Code Grant of OAuth2.

> Connect-Safeguard -Insecure 192.168.123.123 -Browser
Login Successful.

If your appliance still has Resource Owner Grant enabled, the legacy login style (without -Pkce or -Browser) will continue to work:

> Connect-Safeguard -Insecure 192.168.123.123 local Admin
Password: ********
Login Successful.

The Connect-Safeguard cmdlet will create a session variable that includes your access token and connection information. This makes it easier to call other cmdlets provided by the module.

Client certificate authentication is also available in Connect-Safeguard. This can be done either using a PFX certificate file or a SHA-1 thumbprint of a certificate stored in the Current User personal certificate store.

Once you are logged in, you can call any cmdlet listed below. For example:

> Get-SafeguardUser Admin

If you do not have rights to access a particular portion of the Web API, you will be presented with an error message saying authorization is required.

> Get-SafeguardAsset
Invoke-RestMethod : {"Code":60108,"Message":"Authorization is required for this request.","InnerError":null}

When you are finished, you can close the session or call the Disconnect-Safeguard cmdlet to invalidate and remove your access token.

Discover Available cmdlets

Use the Get-SafeguardCommand to see what is available from the module.

Since there are so many cmdlets in safeguard-ps you can use filters to find exactly the cmdlet you are looking for.

For example:

> Get-SafeguardCommand Get Account Dir

CommandType     Name                                               Version    Source
-----------     ----                                               -------    ------
Function        Get-SafeguardDirectoryAccount                      2.1.0.9... safeguard-ps

Module Versioning

The version of safeguard-ps mirrors the version of Safeguard that it was developed and tested against. However, the build numbers (fourth number) should not be expected to match.

For Example:

safeguard-ps 2.2.152 would correspond to Safeguard 2.2.0.6958.

This does not mean that safeguard-ps 2.2.152 won't work at all with Safeguard 2.4.0.7846. For the most part the cmdlets will still work, but you may occasionally come across things that are broken.

For the best results, please try to match the first two version numbers of the safeguard-ps module to the first two numbers of the Safeguard appliance you are communicating with. The most important thing for safeguard-ps is the version of the Safeguard Web API, which will never change between where only the third and fourth numbers differ.

Pre-release Builds

As of version 2.2.x, safeguard-ps began using a three digit version number. It also now supports prerelease builds. This is so the next version of safeguard-ps can be developed in lock step with the Safeguard product.

Dropping the third number is insignificant as the Safeguard Web API never changes in those releases.

API v3

Safeguard 2.7 shipped with a new version of the Safeguard API (v3). The safeguard-ps 2.7 module was updated to use the v3 API by default. Safeguard 2.7 serves both the v2 and v3 APIs, but the v3 version of the API is the only one guaranteed to work. Please try to match the first and second version numbers between Safeguard and safeguard-ps as instructed above to avoid any compatibility issues.

Getting Started With A2A

Once you have configured your A2A registration in Safeguard, you can get the information to call Safeguard A2A by running the following:

> Get-SafeguardA2aCredentialRetrievalInformation

This will report the certificate thumbprint you need to use as well as the API key required to request a specific account password.

The best practice is to install your user certificate in the Windows User Certificate Store (user the Personal folder). Then, you can reference the certificate securely in safeguard-ps just using the thumbprint.

You can see the thumbprints of certificates currently installed in your Windows User Certificate Store using the following command:

> Get-ChildItem Cert:\CurrentUser\My

To retrieve a password via A2A from PowerShell use Get-SafeguardA2aPassword. For example:

> Get-SafeguardA2aPassword 10.5.5.5 -Thumbprint 756766BB590D7FA9CA9E1971A4AE41BB9CEC82F1 -ApiKey JeD9HIgGZM+CYZcVk6YHDNCp4W36DNsjS1TDi+S5HzI=

Reporting and CSV output

Safeguard 2.6 added the capability of returning CSV from the API by passing in an Accept header set to 'text/csv'. Several reporting cmdlets were built on this functionality.

Run:

> Get-SafeguardCommand report

to see all of these reporting cmdlets.

The following video shows how the reporting cmdlets work, including parameters for opening the output directly in Excel.

Reporting Cmdlet video

Reporting Cmdlet video

Development

PowerShell development can be done many ways, this is just one way with Visual Studio Code.

Requirements

Editing

  • Start Visual Studio Code.
  • Open root folder of safeguard-ps.
  • Create or modify the scripts and save the changes.

Executing

  • Open a Terminal in Visual Studio Code and execute the following.

    If you have installed the safeguard-ps module uninstall it.

    Remove-Module safeguard-ps
    

    Install the new or modified scripts.

    ./install-local.ps1
    
  • Test your changes

    Before testing any new changes you must run Remove-Module safeguard-ps cleanup-local.ps1 and install-local.ps1.

PowerShell Cmdlets

Every cmdlet supports Get-Help for detailed usage information. Use Get-SafeguardCommand to search for cmdlets by keyword at any time.

Aliases are shown in parentheses where available.

Management Shell

  • Get-SafeguardCommand
  • Get-SafeguardBanner
  • Open-CsvInExcel

Core Functionality

  • Connect-Safeguard
  • Disconnect-Safeguard
  • Invoke-SafeguardMethod
  • Get-SafeguardAccessTokenStatus
  • Update-SafeguardAccessToken
  • Get-SafeguardLoggedInUser
  • Switch-SafeguardConnectionVersion
  • Confirm-SafeguardStaAcceptance

Data Types

  • Get-SafeguardIdentityProviderType
  • Get-SafeguardPlatform
  • Find-SafeguardPlatform
  • Get-SafeguardTimeZone
  • Get-SafeguardTransferProtocol

Licensing

  • Get-SafeguardLicense
  • Install-SafeguardLicense
  • Uninstall-SafeguardLicense

Certificates

  • Get-SafeguardTrustedCertificate
  • Install-SafeguardTrustedCertificate
  • Uninstall-SafeguardTrustedCertificate
  • Get-SafeguardSslCertificate
  • Install-SafeguardSslCertificate
  • Uninstall-SafeguardSslCertificate
  • Get-SafeguardSslCertificateForAppliance
  • Set-SafeguardSslCertificateForAppliance
  • Clear-SafeguardSslCertificateForAppliance
  • Get-SafeguardAuditLogSigningCertificate
  • Install-SafeguardAuditLogSigningCertificate
  • Uninstall-SafeguardAuditLogSigningCertificate
  • Get-SafeguardCertificateSigningRequest (Get-SafeguardCsr)
  • New-SafeguardCertificateSigningRequest (New-SafeguardCsr)
  • Remove-SafeguardCertificateSigningRequest (Remove-SafeguardCsr)
  • New-SafeguardTestCertificatePki

Networking

  • Get-SafeguardNetworkInterface
  • Set-SafeguardNetworkInterface
  • Get-SafeguardDnsSuffix
  • Set-SafeguardDnsSuffix

Maintenance

  • Get-SafeguardStatus
  • Get-SafeguardVersion
  • Test-SafeguardVersion
  • Get-SafeguardHealth
  • Get-SafeguardApplianceAvailability
  • Get-SafeguardApplianceState
  • Wait-SafeguardApplianceStateOnline
  • Get-SafeguardApplianceVerification
  • Get-SafeguardTime
  • Set-SafeguardTime
  • Get-SafeguardApplianceUptime
  • Get-SafeguardApplianceName
  • Set-SafeguardApplianceName
  • Get-SafeguardApplianceDnsSuffix
  • Set-SafeguardApplianceDnsSuffix
  • Get-SafeguardApplianceDnsName
  • Invoke-SafeguardApplianceShutdown
  • Invoke-SafeguardApplianceReboot
  • Invoke-SafeguardApplianceFactoryReset
  • Get-SafeguardSupportBundle
  • Get-SafeguardSupportBundleQuickGlance
  • Get-SafeguardPatch
  • Clear-SafeguardPatch
  • Set-SafeguardPatch
  • Install-SafeguardPatch
  • Get-SafeguardBackup
  • New-SafeguardBackup
  • Remove-SafeguardBackup
  • Export-SafeguardBackup
  • Import-SafeguardBackup
  • Restore-SafeguardBackup
  • Save-SafeguardBackupToArchive
  • Get-SafeguardBmcConfiguration
  • Enable-SafeguardBmcConfiguration
  • Disable-SafeguardBmcConfiguration
  • Set-SafeguardBmcAdminPassword
  • Get-SafeguardTls12OnlyStatus
  • Enable-SafeguardTls12Only
  • Disable-SafeguardTls12Only
  • Test-SafeguardAuditLogArchive

Diagnostics

  • Invoke-SafeguardPing
  • Invoke-SafeguardTelnet
  • Invoke-SafeguardTraceroute
  • Invoke-SafeguardArp
  • Invoke-SafeguardNetstat
  • Invoke-SafeguardNsLookup
  • Invoke-SafeguardShowRoutes
  • Invoke-SafeguardCldapPing
  • Invoke-SafeguardClusterPing
  • Invoke-SafeguardClusterThroughput
  • Invoke-SafeguardMemberPing
  • Invoke-SafeguardMemberThroughput
  • Get-SafeguardDiagnosticPackage
  • Set-SafeguardDiagnosticPackage
  • Clear-SafeguardDiagnosticPackage
  • Invoke-SafeguardDiagnosticPackage
  • Get-SafeguardDiagnosticPackageLog
  • Get-SafeguardDiagnosticPackageStatus

Clustering

  • Get-SafeguardClusterMember
  • Add-SafeguardClusterMember
  • Remove-SafeguardClusterMember
  • Get-SafeguardClusterHealth
  • Get-SafeguardClusterPrimary
  • Set-SafeguardClusterPrimary
  • Enable-SafeguardClusterPrimary
  • Get-SafeguardClusterOperationStatus
  • Unlock-SafeguardCluster (Clear-SafeguardClusterOperation)
  • Get-SafeguardClusterSummary
  • Get-SafeguardClusterPlatformTaskLoadStatus
  • Get-SafeguardClusterPlatformTaskQueueStatus
  • Get-SafeguardClusterVpnIpv6Address

Session Cluster Join

  • Get-SafeguardSessionCluster
  • Set-SafeguardSessionCluster
  • Join-SafeguardSessionCluster
  • Split-SafeguardSessionCluster
  • Get-SafeguardSessionSplitCluster
  • Remove-SafeguardSessionSplitCluster
  • Get-SafeguardSessionClusterAccessRequestBroker
  • Enable-SafeguardSessionClusterAccessRequestBroker
  • Disable-SafeguardSessionClusterAccessRequestBroker
  • Get-SafeguardSessionClusterAuditStream
  • Enable-SafeguardSessionClusterAuditStream
  • Disable-SafeguardSessionClusterAuditStream

Safeguard for Privileged Sessions (SPS) Web API

  • Connect-SafeguardSps
  • Disconnect-SafeguardSps
  • Invoke-SafeguardSpsMethod
  • Open-SafeguardSpsTransaction
  • Close-SafeguardSpsTransaction (Save-SafeguardSpsTransaction)
  • Get-SafeguardSpsTransaction
  • Clear-SafeguardSpsTransaction
  • Show-SafeguardSpsTransactionChange
  • Show-SafeguardSpsEndpoint
  • Get-SafeguardSpsInfo
  • Get-SafeguardSpsVersion
  • Get-SafeguardSpsLoginMethod
  • Get-SafeguardSpsSupportBundle
  • Get-SafeguardSpsWelcomeWizardStatus
  • Complete-SafeguardSpsWelcomeWizard
  • Enable-SafeguardSpsRemoteAccess (Enable-SafeguardSpsSra)
  • Disable-SafeguardSpsRemoteAccess (Disable-SafeguardSpsSra)
  • Invoke-SafeguardSpsStarlingJoinBrowser
  • Remove-SafeguardSpsStarlingJoin
  • Get-SafeguardSpsFirmwareSlot
  • Import-SafeguardSpsFirmware
  • Install-SafeguardSpsFirmware
  • Install-SafeguardSpsUpgrade
  • Test-SafeguardSpsFirmware

Users

  • Get-SafeguardIdentityProvider
  • Get-SafeguardAuthenticationProvider
  • Set-SafeguardAuthenticationProviderAsDefault
  • Clear-SafeguardAuthenticationProviderAsDefault
  • Get-SafeguardUser
  • Find-SafeguardUser
  • New-SafeguardUser
  • Edit-SafeguardUser
  • Remove-SafeguardUser
  • Enable-SafeguardUser
  • Disable-SafeguardUser
  • Rename-SafeguardUser
  • Set-SafeguardUserPassword
  • Import-SafeguardUser
  • New-SafeguardUserImportTemplate
  • Get-SafeguardUserLinkedAccount
  • Add-SafeguardUserLinkedAccount
  • Remove-SafeguardUserLinkedAccount
  • Get-SafeguardUserPreference
  • Set-SafeguardUserPreference
  • Remove-SafeguardUserPreference
  • Sync-SafeguardUserGroupAuthenticationProvider

Asset Partitions

  • Get-SafeguardAssetPartition
  • New-SafeguardAssetPartition
  • Edit-SafeguardAssetPartition
  • Remove-SafeguardAssetPartition
  • Get-SafeguardAssetPartitionOwner
  • Add-SafeguardAssetPartitionOwner
  • Remove-SafeguardAssetPartitionOwner
  • Enter-SafeguardAssetPartition
  • Exit-SafeguardAssetPartition
  • Get-SafeguardCurrentAssetPartition

Assets

  • Get-SafeguardAsset
  • Find-SafeguardAsset
  • New-SafeguardAsset
  • Edit-SafeguardAsset
  • Remove-SafeguardAsset
  • Test-SafeguardAsset
  • Import-SafeguardAsset
  • New-SafeguardAssetImportTemplate
  • Sync-SafeguardDirectoryAsset

Asset Accounts

  • Get-SafeguardAssetAccount
  • Find-SafeguardAssetAccount
  • New-SafeguardAssetAccount
  • Edit-SafeguardAssetAccount
  • Remove-SafeguardAssetAccount
  • Enable-SafeguardAssetAccount
  • Disable-SafeguardAssetAccount
  • Set-SafeguardAssetAccountPassword
  • New-SafeguardAssetAccountRandomPassword
  • Test-SafeguardAssetAccountPassword
  • Invoke-SafeguardAssetAccountPasswordChange
  • Set-SafeguardAssetAccountSshKey
  • Test-SafeguardAssetAccountSshKey
  • Invoke-SafeguardAssetAccountSshKeyChange
  • Invoke-SafeguardAssetSshHostKeyDiscovery
  • Import-SafeguardAssetAccount
  • Import-SafeguardAssetAccountPassword
  • Import-SafeguardAssetAccountSshKey
  • New-SafeguardAssetAccountImportTemplate
  • New-SafeguardAssetAccountPasswordImportTemplate
  • New-SafeguardAssetAccountSshKeyImportTemplate

Custom Platforms

  • Get-SafeguardCustomPlatform
  • New-SafeguardCustomPlatform
  • Edit-SafeguardCustomPlatform
  • Remove-SafeguardCustomPlatform
  • New-SafeguardCustomPlatformAsset
  • Set-SafeguardCustomPlatformAssetParameter
  • Get-SafeguardCustomPlatformScriptParameter
  • Import-SafeguardCustomPlatformScript
  • Export-SafeguardCustomPlatformScript
  • Test-SafeguardCustomPlatformScript

Directories

  • Get-SafeguardDirectory
  • New-SafeguardDirectory
  • Edit-SafeguardDirectory
  • Remove-SafeguardDirectory
  • Test-SafeguardDirectory
  • Sync-SafeguardDirectory
  • Get-SafeguardDirectoryMigrationData
  • Get-SafeguardDirectoryIdentityProvider
  • New-SafeguardDirectoryIdentityProvider
  • Edit-SafeguardDirectoryIdentityProvider
  • Remove-SafeguardDirectoryIdentityProvider
  • Sync-SafeguardDirectoryIdentityProvider
  • Get-SafeguardDirectoryIdentityProviderDomain
  • Get-SafeguardDirectoryIdentityProviderSchemaMapping
  • Set-SafeguardDirectoryIdentityProviderSchemaMapping

Directory Accounts

  • Get-SafeguardDirectoryAccount
  • Find-SafeguardDirectoryAccount
  • New-SafeguardDirectoryAccount
  • Edit-SafeguardDirectoryAccount
  • Remove-SafeguardDirectoryAccount
  • Set-SafeguardDirectoryAccountPassword
  • New-SafeguardDirectoryAccountRandomPassword
  • Test-SafeguardDirectoryAccountPassword
  • Invoke-SafeguardDirectoryAccountPasswordChange

Profiles & Schedules

  • Get-SafeguardPasswordProfile
  • New-SafeguardPasswordProfile
  • Edit-SafeguardPasswordProfile
  • Remove-SafeguardPasswordProfile
  • Rename-SafeguardPasswordProfile
  • Copy-SafeguardPasswordProfile
  • Get-SafeguardPasswordProfileAccount
  • Add-SafeguardPasswordProfileAccount
  • Remove-SafeguardPasswordProfileAccount
  • Get-SafeguardPasswordProfileAsset
  • Add-SafeguardPasswordProfileAsset
  • Remove-SafeguardPasswordProfileAsset
  • Get-SafeguardAccountPasswordRule
  • New-SafeguardAccountPasswordRule
  • Edit-SafeguardAccountPasswordRule
  • Remove-SafeguardAccountPasswordRule
  • Rename-SafeguardAccountPasswordRule
  • Copy-SafeguardAccountPasswordRule
  • Get-SafeguardPasswordCheckSchedule
  • New-SafeguardPasswordCheckSchedule
  • Edit-SafeguardPasswordCheckSchedule
  • Remove-SafeguardPasswordCheckSchedule
  • Rename-SafeguardPasswordCheckSchedule
  • Copy-SafeguardPasswordCheckSchedule
  • Get-SafeguardPasswordChangeSchedule
  • New-SafeguardPasswordChangeSchedule
  • Edit-SafeguardPasswordChangeSchedule
  • Remove-SafeguardPasswordChangeSchedule
  • Rename-SafeguardPasswordChangeSchedule
  • Copy-SafeguardPasswordChangeSchedule
  • New-SafeguardSchedule
  • New-SafeguardScheduleDaily
  • New-SafeguardScheduleWeekly
  • New-SafeguardScheduleMonthlyByDay
  • New-SafeguardScheduleMonthlyByDayOfWeek

Groups

User Groups:

  • Get-SafeguardUserGroup
  • New-SafeguardUserGroup
  • Edit-SafeguardUserGroup
  • Remove-SafeguardUserGroup
  • Get-SafeguardUserGroupMember
  • Add-SafeguardUserGroupMember
  • Remove-SafeguardUserGroupMember

Asset Groups:

  • Get-SafeguardAssetGroup
  • New-SafeguardAssetGroup
  • Edit-SafeguardAssetGroup
  • Remove-SafeguardAssetGroup
  • Get-SafeguardAssetGroupMember
  • Add-SafeguardAssetGroupMember
  • Remove-SafeguardAssetGroupMember

Account Groups:

  • Get-SafeguardAccountGroup
  • New-SafeguardAccountGroup
  • Edit-SafeguardAccountGroup
  • Remove-SafeguardAccountGroup
  • Get-SafeguardAccountGroupMember
  • Add-SafeguardAccountGroupMember
  • Remove-SafeguardAccountGroupMember

Dynamic Groups:

  • Get-SafeguardDynamicAssetGroup
  • New-SafeguardDynamicAssetGroup
  • Edit-SafeguardDynamicAssetGroup
  • Get-SafeguardDynamicAccountGroup
  • New-SafeguardDynamicAccountGroup
  • Edit-SafeguardDynamicAccountGroup

Entitlements & Access Policies

  • Get-SafeguardEntitlement
  • New-SafeguardEntitlement
  • Edit-SafeguardEntitlement
  • Remove-SafeguardEntitlement
  • Add-SafeguardEntitlementMember
  • Remove-SafeguardEntitlementMember
  • Get-SafeguardAccessPolicy
  • Add-SafeguardAccessPolicy
  • Edit-SafeguardAccessPolicy
  • Remove-SafeguardAccessPolicy
  • Get-SafeguardAccessPolicyScopeItem
  • Get-SafeguardAccessPolicyAccessRequestProperty
  • Get-SafeguardAccessPolicySessionProperty
  • Get-SafeguardPolicyAsset
  • Find-SafeguardPolicyAsset
  • Get-SafeguardPolicyAccount
  • Find-SafeguardPolicyAccount

Access Requests

  • Get-SafeguardAccessRequest
  • Find-SafeguardAccessRequest
  • New-SafeguardAccessRequest
  • Edit-SafeguardAccessRequest
  • Close-SafeguardAccessRequest
  • Approve-SafeguardAccessRequest
  • Deny-SafeguardAccessRequest (Revoke-SafeguardAccessRequest)
  • Assert-SafeguardAccessRequest
  • Get-SafeguardActionableRequest
  • Get-SafeguardMyRequest
  • Get-SafeguardMyApproval
  • Get-SafeguardMyReview
  • Get-SafeguardRequestableAccount (Get-SafeguardMyRequestable)
  • Find-SafeguardRequestableAccount (Find-SafeguardMyRequestable)
  • Get-SafeguardAccessRequestPassword (Get-SafeguardAccessRequestCheckoutPassword)
  • Copy-SafeguardAccessRequestPassword
  • Get-SafeguardAccessRequestSshHostKey
  • Get-SafeguardAccessRequestSshKey
  • Get-SafeguardAccessRequestSshUrl
  • Get-SafeguardAccessRequestRdpFile
  • Get-SafeguardAccessRequestRdpUrl
  • Get-SafeguardAccessRequestApiKey
  • Get-SafeguardAccessRequestActionLog
  • Start-SafeguardAccessRequestSession
  • Start-SafeguardAccessRequestWebSession

Tags

  • Get-SafeguardTag
  • Find-SafeguardTag
  • New-SafeguardTag
  • Update-SafeguardTag
  • Remove-SafeguardTag
  • Get-SafeguardTagOccurrence
  • Get-SafeguardAssetTag
  • Add-SafeguardAssetTag
  • Remove-SafeguardAssetTag
  • Update-SafeguardAssetTag
  • Get-SafeguardAssetAccountTag
  • Add-SafeguardAssetAccountTag
  • Remove-SafeguardAssetAccountTag
  • Update-SafeguardAssetAccountTag
  • Test-SafeguardAssetTaggingRule
  • Test-SafeguardAssetAccountTaggingRule

Events

  • Get-SafeguardEvent
  • Find-SafeguardEvent
  • Get-SafeguardEventName
  • Get-SafeguardEventCategory
  • Get-SafeguardEventProperty
  • Get-SafeguardEventSubscription
  • Find-SafeguardEventSubscription
  • New-SafeguardEventSubscription
  • Edit-SafeguardEventSubscription
  • Remove-SafeguardEventSubscription

A2A

Service:

  • Get-SafeguardA2aServiceStatus
  • Enable-SafeguardA2aService
  • Disable-SafeguardA2aService

Registrations:

  • Get-SafeguardA2a
  • New-SafeguardA2a
  • Edit-SafeguardA2a
  • Remove-SafeguardA2a

Credential Retrieval Configuration:

  • Get-SafeguardA2aCredentialRetrievalInformation
  • Get-SafeguardA2aCredentialRetrieval
  • Add-SafeguardA2aCredentialRetrieval
  • Remove-SafeguardA2aCredentialRetrieval
  • Get-SafeguardA2aCredentialRetrievalIpRestriction
  • Set-SafeguardA2aCredentialRetrievalIpRestriction
  • Clear-SafeguardA2aCredentialRetrievalIpRestriction
  • Get-SafeguardA2aCredentialRetrievalApiKey
  • Reset-SafeguardA2aCredentialRetrievalApiKey

Access Request Broker Configuration:

  • Get-SafeguardA2aAccessRequestBroker
  • Set-SafeguardA2aAccessRequestBroker
  • Clear-SafeguardA2aAccessRequestBroker
  • Get-SafeguardA2aAccessRequestBrokerIpRestriction
  • Set-SafeguardA2aAccessRequestBrokerIpRestriction
  • Clear-SafeguardA2aAccessRequestBrokerIpRestriction
  • Get-SafeguardA2aAccessRequestBrokerApiKey
  • Reset-SafeguardA2aAccessRequestBrokerApiKey

Credential Retrieval (calling A2A):

  • Get-SafeguardA2aRetrievableAccount
  • Get-SafeguardA2aPassword
  • Set-SafeguardA2aPassword
  • Get-SafeguardA2aPrivateKey
  • Set-SafeguardA2aPrivateKey
  • Get-SafeguardA2aApiKeySecret

Access Request Broker (calling A2A):

  • New-SafeguardA2aAccessRequest

One Identity Starling

  • Invoke-SafeguardStarlingJoinBrowser
  • Invoke-SafeguardStarlingJoin
  • Get-SafeguardStarlingJoinUrl
  • Get-SafeguardStarlingJoinInstance
  • Get-SafeguardStarlingSubscription
  • New-SafeguardStarlingSubscription
  • Remove-SafeguardStarlingSubscription
  • Get-SafeguardStarlingSetting
  • Set-SafeguardStarlingSetting

Reports

  • Get-SafeguardReportA2aEntitlement
  • Get-SafeguardReportAccountGroupMembership
  • Get-SafeguardReportAccountWithoutPassword
  • Get-SafeguardReportAssetAccountPasswordHistory (Get-SafeguardPasswordHistory)
  • Get-SafeguardReportAssetGroupMembership
  • Get-SafeguardReportAssetManagementConfiguration
  • Get-SafeguardReportDailyAccessRequest
  • Get-SafeguardReportDailyPasswordChangeFail
  • Get-SafeguardReportDailyPasswordChangeSuccess
  • Get-SafeguardReportDailyPasswordCheckFail
  • Get-SafeguardReportDailyPasswordCheckSuccess
  • Get-SafeguardReportPasswordLastChanged
  • Get-SafeguardReportUserEntitlement
  • Get-SafeguardReportUserGroupMembership

Archive Servers

  • Get-SafeguardArchiveServer
  • New-SafeguardArchiveServer
  • Edit-SafeguardArchiveServer
  • Remove-SafeguardArchiveServer
  • Test-SafeguardArchiveServer

Settings

  • Get-SafeguardApplianceSetting
  • Set-SafeguardApplianceSetting
  • Get-SafeguardCoreSetting
  • Set-SafeguardCoreSetting
  • Get-SafeguardDebugSettings
  • Set-SafeguardDebugSettings
  • Enable-SafeguardTlsLogging
  • Disable-SafeguardTlsLogging
  • Get-SafeguardSyslogServer
  • New-SafeguardSyslogServer
  • Edit-SafeguardSyslogServer
  • Remove-SafeguardSyslogServer

Deleted Objects

  • Get-SafeguardDeletedAsset
  • Remove-SafeguardDeletedAsset
  • Restore-SafeguardDeletedAsset
  • Get-SafeguardDeletedAssetAccount
  • Remove-SafeguardDeletedAssetAccount
  • Restore-SafeguardDeletedAssetAccount
  • Get-SafeguardDeletedUser
  • Remove-SafeguardDeletedUser
  • Restore-SafeguardDeletedUser
  • Get-SafeguardPurgeSettings
  • Update-SafeguardPurgeSettings
  • Reset-SafeguardPurgeSettings

Audit Log

  • Get-SafeguardAuditLog

About

One Identity Safeguard PowerShell scripting resources

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors