ensono / a0toolkit Goto Github PK

Appveyor:

A0Toolkit is published in the Chocolatey packages community feed.

As A0Tookit is a PowerShell module it will autoload when any exported functions are invoked.

List of exported functions:

1.4.0

• Get-A0ClientGrant
• New-A0ClientGrant
• Remove-A0ClientGrant
• Set-A0ClientGrant

1.3.0

• Get-A0EmailTemplate
• Set-A0EmailTemplate

1.2.0

• Get-A0RuleConfig
• Remove-A0RuleConfig
• Set-A0RuleConfig

1.1.0

• Remove-A0ResourceServer

1.0.0

• Get-A0Client
• Get-A0ClientGrants
• Get-A0Connection
• Get-A0EmailProvider
• Get-A0ResourceServer
• New-A0Connection
• New-A0EmailProvider
• New-A0Token
• Remove-A0Client
• Remove-A0Connection
• Set-A0Client
• Set-A0Connection
• Set-A0EmailProvider
• Set-A0Tenant

Using a combination of the Auth0 Deploy CLI node application and the above module, provisioning of Auth0 can largely be automated and integrated into a deployment pipeline.

In the folder SampleOrchestrationScript there is an example of how to orchestrate the functions above into a working solution.

This composes of a PowerShell script Set-Auth0Tenant and a json configuration file powershell.auth0.config.json

The json file consist of:

Array of Environments
Common can be used for shared values and overridden by other environments. If integrating into a deployment pipeline, the common environment values can be tokenised, as in the example. A token is denoted by #{xxx}

Auth0 Configuration
These sections closely align to Auth0 resources:

• account
• clients
• clients\clientGrants
• connections
• email
• emailTemplates
• ruleConfigs

These sections are custom and protect the resources from being deleted by the PowerShell script:

• protectedClients
• protectedConnections
• protectedResourceServers

These properties are required to acquire a Auth0 Management token:

• domain
• clientId
• clientSecret

This would load any sections/properties from the 'dev' environment and then any additional sections/properties from the common envrionment.

Set-Auth0Tenant -targetEnvironment 'dev'