diff --git a/src/cli/FrodoCommand.ts b/src/cli/FrodoCommand.ts index 461935d9e..acc332a95 100644 --- a/src/cli/FrodoCommand.ts +++ b/src/cli/FrodoCommand.ts @@ -16,9 +16,9 @@ import { const { DEFAULT_REALM_KEY, DEPLOYMENT_TYPES } = frodo.utils.constants; -const hostArgument = new Argument( +export const hostArgument = new Argument( '[host]', - 'AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a unique substring.' + 'AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a unique substring or alias.' ); const realmArgument = new Argument( diff --git a/src/cli/app/app-list.ts b/src/cli/app/app-list.ts index 16e8f7d08..dbca49c9a 100644 --- a/src/cli/app/app-list.ts +++ b/src/cli/app/app-list.ts @@ -28,7 +28,7 @@ export default function setup() { ] + ` List applications using a connection profile (identified by the full AM base URL):\n` + ` $ frodo app list ${s.amBaseUrl}\n`['brightCyan'] + - ` List applications using a connection profile (identified by a unique substring of the AM base URL):\n` + + ` List applications using a connection profile (identified by a unique substring of the AM base URL or a saved alias):\n` + ` $ frodo app list ${s.connId}\n`['brightCyan'] ) .action( diff --git a/src/cli/conn/conn-alias-add.ts b/src/cli/conn/conn-alias-add.ts new file mode 100644 index 000000000..0206b27b7 --- /dev/null +++ b/src/cli/conn/conn-alias-add.ts @@ -0,0 +1,34 @@ +import { frodo } from '@rockcarver/frodo-lib'; + +import { printError } from '../../utils/Console'; +import { FrodoCommand, hostArgument } from '../FrodoCommand'; + +export default function setup() { + const program = new FrodoCommand('frodo conn alias add', [ + 'host', + 'realm', + 'username', + 'password', + 'type', + 'insecure', + 'curlirize', + ]); + + program + .description('Add connection profile alias.') + .argument('alias', 'Alias name for this connection profile.') + .addArgument(hostArgument) + .action( + async (alias: any, host: string, options: any, command: FrodoCommand) => { + command.handleDefaultArgsAndOpts(alias, host, options, command); + try { + frodo.conn.setConnectionProfileAlias(host, alias); + } catch (error) { + printError(error); + process.exitCode = 1; + } + } + ); + + return program; +} diff --git a/src/cli/conn/conn-alias-delete.ts b/src/cli/conn/conn-alias-delete.ts new file mode 100644 index 000000000..8bb358294 --- /dev/null +++ b/src/cli/conn/conn-alias-delete.ts @@ -0,0 +1,29 @@ +import { frodo } from '@rockcarver/frodo-lib'; + +import { printError } from '../../utils/Console'; +import { FrodoCommand } from '../FrodoCommand'; + +export default function setup() { + const program = new FrodoCommand('frodo conn alias delete', [ + 'realm', + 'username', + 'password', + 'type', + 'insecure', + 'curlirize', + ]); + + program + .description('Delete connection profile alias.') + .action(async (host: string, options: any, command: FrodoCommand) => { + command.handleDefaultArgsAndOpts(host, options, command); + try { + frodo.conn.deleteConnectionProfileAlias(host); + } catch (error) { + printError(error); + process.exitCode = 1; + } + }); + + return program; +} diff --git a/src/cli/conn/conn-alias.ts b/src/cli/conn/conn-alias.ts new file mode 100644 index 000000000..5c817777b --- /dev/null +++ b/src/cli/conn/conn-alias.ts @@ -0,0 +1,19 @@ +import { FrodoStubCommand } from '../FrodoCommand'; +import AddCmd from './conn-alias-add.js'; +import DeleteCmd from './conn-alias-delete.js'; + +export default function setup() { + const program = new FrodoStubCommand('frodo conn alias'); + + program.description('Manage connection aliases.'); + + program.addCommand( + AddCmd().name('add').description('Add connection profile alias.') + ); + + program.addCommand( + DeleteCmd().name('delete').description('Delete connection profile alias.') + ); + + return program; +} diff --git a/src/cli/conn/conn-save.ts b/src/cli/conn/conn-save.ts index e48fa69d0..6d27303d3 100644 --- a/src/cli/conn/conn-save.ts +++ b/src/cli/conn/conn-save.ts @@ -50,6 +50,9 @@ export default function setup() { 'Map of headers: {"host":"am.example.com:8081"}.' ) ) + .addOption( + new Option('--alias [name]', 'Alias name for this connection profile.') + ) .addHelpText( 'after', `Usage Examples:\n` + @@ -57,10 +60,18 @@ export default function setup() { ` $ frodo conn save ${s.amBaseUrl} ${s.username} '${s.password}'\n`[ 'brightCyan' ] + + ` Create a connection profile with a new log API key and secret and a new service account and set an alias:\n` + + ` $ frodo conn save --alias ${s.alias} ${s.amBaseUrl} ${s.username} '${s.password}'\n`[ + 'brightCyan' + ] + ` Save an existing service account to an existing or new connection profile:\n` + ` $ frodo conn save --sa-id ${s.saId} --sa-jwk-file ${s.saJwkFile} ${s.amBaseUrl}\n`[ 'brightCyan' ] + + ` Save an existing service account to an existing or new connection profile and set an alias:\n` + + ` $ frodo conn save --alias ${s.alias} --sa-id ${s.saId} --sa-jwk-file ${s.saJwkFile} ${s.amBaseUrl}\n`[ + 'brightCyan' + ] + ` Save an existing service account to an existing connection profile (partial host URL only updates an existing profile):\n` + ` $ frodo conn save --sa-id ${s.saId} --sa-jwk-file ${s.saJwkFile} ${s.connId}\n`[ 'brightCyan' @@ -103,6 +114,9 @@ export default function setup() { verboseMessage( `Saving connection profile for tenant ${state.getHost()}...` ); + if (options.alias) { + state.setAlias(options.alias); + } // if cloud deployment add service account if ( options.validate && diff --git a/src/cli/conn/conn.ts b/src/cli/conn/conn.ts index a11f525a8..30bc8527f 100644 --- a/src/cli/conn/conn.ts +++ b/src/cli/conn/conn.ts @@ -1,4 +1,5 @@ import { FrodoStubCommand } from '../FrodoCommand'; +import AliasCmd from './conn-alias.js'; import DeleteCmd from './conn-delete.js'; import DescribeCmd from './conn-describe.js'; import ListCmd from './conn-list.js'; @@ -13,6 +14,8 @@ export default function setup() { program.addCommand(SaveCmd().name('save')); + program.addCommand(AliasCmd().name('alias')); + program.addCommand(DeleteCmd().name('delete')); program.addCommand(DescribeCmd().name('describe')); diff --git a/src/cli/info/info.ts b/src/cli/info/info.ts index 3324d3275..1b78a0216 100644 --- a/src/cli/info/info.ts +++ b/src/cli/info/info.ts @@ -34,9 +34,9 @@ export default function setup() { ] + ` Show human-readable output and login using a connection profile (identified by the full AM base URL):\n` + ` $ frodo info ${s.amBaseUrl}\n`['brightCyan'] + - ` Show human-readable output and login using a connection profile (identified by a unique substring of the AM base URL):\n` + + ` Show human-readable output and login using a connection profile (identified by a unique substring of the AM base URL or a saved alias):\n` + ` $ frodo info ${s.connId}\n`['brightCyan'] + - ` Show JSON output and login using the AM base URL's unique substring to identify the connection profile:\n` + + ` Show JSON output and login using the AM base URL's unique substring or a saved alias to identify the connection profile:\n` + ` $ frodo info --json ${s.connId}\n`['brightCyan'] ) .action(async (host, user, password, options, command) => { diff --git a/src/cli/shell/shell.ts b/src/cli/shell/shell.ts index 9a19728bb..d8c5cc57e 100644 --- a/src/cli/shell/shell.ts +++ b/src/cli/shell/shell.ts @@ -57,7 +57,7 @@ export default function setup() { ] + ` Launch a frodo shell using a connection profile (identified by the full AM base URL):\n` + ` $ frodo shell ${s.amBaseUrl}\n`['brightCyan'] + - ` Launch a frodo shell using a connection profile (identified by a unique substring of the AM base URL):\n` + + ` Launch a frodo shell using a connection profile (identified by a unique substring of the AM base URL or a saved alias):\n` + ` $ frodo shell ${s.connId}\n`['brightCyan'] ) .addOption( diff --git a/src/help/SampleData.ts b/src/help/SampleData.ts index 031526051..219def1f6 100644 --- a/src/help/SampleData.ts +++ b/src/help/SampleData.ts @@ -1,4 +1,5 @@ export const amBaseUrl = 'https://openam-matrix.id.forgerock.io/am'; +export const alias = 'MyConnection'; export const connId = 'matrix'; export const username = 'thomas.anderson@metacortex.com'; export const password = 'Blu3P!ll3d'; diff --git a/src/ops/ConnectionProfileOps.ts b/src/ops/ConnectionProfileOps.ts index 44d4291dc..5b771c904 100644 --- a/src/ops/ConnectionProfileOps.ts +++ b/src/ops/ConnectionProfileOps.ts @@ -31,6 +31,7 @@ export function listConnectionProfiles(long: boolean = false): void { if (long) { const table = createTable([ 'Host', + 'Alias', 'Service Account', 'Username', 'Log API Key', @@ -38,6 +39,7 @@ export function listConnectionProfiles(long: boolean = false): void { Object.keys(connectionsData).forEach((c) => { table.push([ c, + connectionsData[c].alias, connectionsData[c].svcacctName || connectionsData[c].svcacctId, connectionsData[c].username, connectionsData[c].logApiKey, @@ -51,7 +53,7 @@ export function listConnectionProfiles(long: boolean = false): void { // getUniqueNames(5, Object.keys(connectionsData)); } printMessage( - 'Any unique substring of a saved host can be used as the value for host parameter in all commands', + 'Any unique substring or alias of a saved host can be used as the value for host parameter in all commands', 'info' ); } @@ -63,7 +65,7 @@ export function listConnectionProfiles(long: boolean = false): void { /** * Describe connection profile - * @param {string} host Host URL or unique substring + * @param {string} host Host URL, unique substring, or alias * @param {boolean} showSecrets Whether secrets should be shown in clear text or not */ export async function describeConnectionProfile( @@ -130,6 +132,7 @@ export async function describeConnectionProfile( } const keyMap = { tenant: 'Host', + alias: 'Alias', deploymentType: 'Deployment Type', username: 'Username', password: 'Password', diff --git a/test/client_cli/en/__snapshots__/admin-add-autoid-static-user-mapping.test.js.snap b/test/client_cli/en/__snapshots__/admin-add-autoid-static-user-mapping.test.js.snap index b55c8d804..2f827833f 100644 --- a/test/client_cli/en/__snapshots__/admin-add-autoid-static-user-mapping.test.js.snap +++ b/test/client_cli/en/__snapshots__/admin-add-autoid-static-user-mapping.test.js.snap @@ -10,7 +10,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. diff --git a/test/client_cli/en/__snapshots__/admin-create-oauth2-client-with-admin-privileges.test.js.snap b/test/client_cli/en/__snapshots__/admin-create-oauth2-client-with-admin-privileges.test.js.snap index 255e07e34..7c160536f 100644 --- a/test/client_cli/en/__snapshots__/admin-create-oauth2-client-with-admin-privileges.test.js.snap +++ b/test/client_cli/en/__snapshots__/admin-create-oauth2-client-with-admin-privileges.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/admin-get-access-token.test.js.snap b/test/client_cli/en/__snapshots__/admin-get-access-token.test.js.snap index 3c97ee932..b310dec37 100644 --- a/test/client_cli/en/__snapshots__/admin-get-access-token.test.js.snap +++ b/test/client_cli/en/__snapshots__/admin-get-access-token.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/admin-grant-oauth2-client-admin-privileges.test.js.snap b/test/client_cli/en/__snapshots__/admin-grant-oauth2-client-admin-privileges.test.js.snap index 0d949b256..c97516f57 100644 --- a/test/client_cli/en/__snapshots__/admin-grant-oauth2-client-admin-privileges.test.js.snap +++ b/test/client_cli/en/__snapshots__/admin-grant-oauth2-client-admin-privileges.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/admin-hide-generic-extension-attributes.test.js.snap b/test/client_cli/en/__snapshots__/admin-hide-generic-extension-attributes.test.js.snap index 96e5fe6fd..1bf55d472 100644 --- a/test/client_cli/en/__snapshots__/admin-hide-generic-extension-attributes.test.js.snap +++ b/test/client_cli/en/__snapshots__/admin-hide-generic-extension-attributes.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/admin-list-oauth2-clients-with-admin-privileges.test.js.snap b/test/client_cli/en/__snapshots__/admin-list-oauth2-clients-with-admin-privileges.test.js.snap index 998383de8..0a8234474 100644 --- a/test/client_cli/en/__snapshots__/admin-list-oauth2-clients-with-admin-privileges.test.js.snap +++ b/test/client_cli/en/__snapshots__/admin-list-oauth2-clients-with-admin-privileges.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/admin-list-oauth2-clients-with-custom-privileges.test.js.snap b/test/client_cli/en/__snapshots__/admin-list-oauth2-clients-with-custom-privileges.test.js.snap index 922e02437..7b0162876 100644 --- a/test/client_cli/en/__snapshots__/admin-list-oauth2-clients-with-custom-privileges.test.js.snap +++ b/test/client_cli/en/__snapshots__/admin-list-oauth2-clients-with-custom-privileges.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/admin-list-static-user-mappings.test.js.snap b/test/client_cli/en/__snapshots__/admin-list-static-user-mappings.test.js.snap index 6235f9b95..87f6f6ff7 100644 --- a/test/client_cli/en/__snapshots__/admin-list-static-user-mappings.test.js.snap +++ b/test/client_cli/en/__snapshots__/admin-list-static-user-mappings.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/admin-remove-static-user-mapping.test.js.snap b/test/client_cli/en/__snapshots__/admin-remove-static-user-mapping.test.js.snap index 550ca843e..79f1c8135 100644 --- a/test/client_cli/en/__snapshots__/admin-remove-static-user-mapping.test.js.snap +++ b/test/client_cli/en/__snapshots__/admin-remove-static-user-mapping.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/admin-repair-org-model.test.js.snap b/test/client_cli/en/__snapshots__/admin-repair-org-model.test.js.snap index a1b861397..7069c0a73 100644 --- a/test/client_cli/en/__snapshots__/admin-repair-org-model.test.js.snap +++ b/test/client_cli/en/__snapshots__/admin-repair-org-model.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/admin-revoke-oauth2-client-admin-privileges.test.js.snap b/test/client_cli/en/__snapshots__/admin-revoke-oauth2-client-admin-privileges.test.js.snap index ec5b8fef1..cdb426657 100644 --- a/test/client_cli/en/__snapshots__/admin-revoke-oauth2-client-admin-privileges.test.js.snap +++ b/test/client_cli/en/__snapshots__/admin-revoke-oauth2-client-admin-privileges.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/admin-show-generic-extension-attributes.test.js.snap b/test/client_cli/en/__snapshots__/admin-show-generic-extension-attributes.test.js.snap index df5163fc9..98916cd0f 100644 --- a/test/client_cli/en/__snapshots__/admin-show-generic-extension-attributes.test.js.snap +++ b/test/client_cli/en/__snapshots__/admin-show-generic-extension-attributes.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/agent-delete.test.js.snap b/test/client_cli/en/__snapshots__/agent-delete.test.js.snap index 8723663b1..ee30edee4 100644 --- a/test/client_cli/en/__snapshots__/agent-delete.test.js.snap +++ b/test/client_cli/en/__snapshots__/agent-delete.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/agent-describe.test.js.snap b/test/client_cli/en/__snapshots__/agent-describe.test.js.snap index c51ae5e4e..83aa36b91 100644 --- a/test/client_cli/en/__snapshots__/agent-describe.test.js.snap +++ b/test/client_cli/en/__snapshots__/agent-describe.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/agent-export.test.js.snap b/test/client_cli/en/__snapshots__/agent-export.test.js.snap index 140f21f16..8cda92c18 100644 --- a/test/client_cli/en/__snapshots__/agent-export.test.js.snap +++ b/test/client_cli/en/__snapshots__/agent-export.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/agent-gateway-delete.test.js.snap b/test/client_cli/en/__snapshots__/agent-gateway-delete.test.js.snap index bc58fdf8f..94d8e98a3 100644 --- a/test/client_cli/en/__snapshots__/agent-gateway-delete.test.js.snap +++ b/test/client_cli/en/__snapshots__/agent-gateway-delete.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/agent-gateway-describe.test.js.snap b/test/client_cli/en/__snapshots__/agent-gateway-describe.test.js.snap index 79f939fb4..083a63eeb 100644 --- a/test/client_cli/en/__snapshots__/agent-gateway-describe.test.js.snap +++ b/test/client_cli/en/__snapshots__/agent-gateway-describe.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/agent-gateway-export.test.js.snap b/test/client_cli/en/__snapshots__/agent-gateway-export.test.js.snap index ce89b195a..fc325bbda 100644 --- a/test/client_cli/en/__snapshots__/agent-gateway-export.test.js.snap +++ b/test/client_cli/en/__snapshots__/agent-gateway-export.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/agent-gateway-import.test.js.snap b/test/client_cli/en/__snapshots__/agent-gateway-import.test.js.snap index d67b2c9f2..bf916ccaa 100644 --- a/test/client_cli/en/__snapshots__/agent-gateway-import.test.js.snap +++ b/test/client_cli/en/__snapshots__/agent-gateway-import.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/agent-gateway-list.test.js.snap b/test/client_cli/en/__snapshots__/agent-gateway-list.test.js.snap index d9fbf7810..a0fae5de1 100644 --- a/test/client_cli/en/__snapshots__/agent-gateway-list.test.js.snap +++ b/test/client_cli/en/__snapshots__/agent-gateway-list.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/agent-import.test.js.snap b/test/client_cli/en/__snapshots__/agent-import.test.js.snap index 3d8bb5213..bdb71bdff 100644 --- a/test/client_cli/en/__snapshots__/agent-import.test.js.snap +++ b/test/client_cli/en/__snapshots__/agent-import.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/agent-java-delete.test.js.snap b/test/client_cli/en/__snapshots__/agent-java-delete.test.js.snap index c2624a67d..859d09f97 100644 --- a/test/client_cli/en/__snapshots__/agent-java-delete.test.js.snap +++ b/test/client_cli/en/__snapshots__/agent-java-delete.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/agent-java-describe.test.js.snap b/test/client_cli/en/__snapshots__/agent-java-describe.test.js.snap index 2cfbf6770..89b10549a 100644 --- a/test/client_cli/en/__snapshots__/agent-java-describe.test.js.snap +++ b/test/client_cli/en/__snapshots__/agent-java-describe.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/agent-java-export.test.js.snap b/test/client_cli/en/__snapshots__/agent-java-export.test.js.snap index 940f712c9..cc18b9232 100644 --- a/test/client_cli/en/__snapshots__/agent-java-export.test.js.snap +++ b/test/client_cli/en/__snapshots__/agent-java-export.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/agent-java-import.test.js.snap b/test/client_cli/en/__snapshots__/agent-java-import.test.js.snap index 53afa6b74..ce24bb5a7 100644 --- a/test/client_cli/en/__snapshots__/agent-java-import.test.js.snap +++ b/test/client_cli/en/__snapshots__/agent-java-import.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/agent-java-list.test.js.snap b/test/client_cli/en/__snapshots__/agent-java-list.test.js.snap index 45b53f8c9..c3e11dc2f 100644 --- a/test/client_cli/en/__snapshots__/agent-java-list.test.js.snap +++ b/test/client_cli/en/__snapshots__/agent-java-list.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/agent-list.test.js.snap b/test/client_cli/en/__snapshots__/agent-list.test.js.snap index 6700357b3..5bf61b85d 100644 --- a/test/client_cli/en/__snapshots__/agent-list.test.js.snap +++ b/test/client_cli/en/__snapshots__/agent-list.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/agent-web-delete.test.js.snap b/test/client_cli/en/__snapshots__/agent-web-delete.test.js.snap index a311eab31..ef675cdf4 100644 --- a/test/client_cli/en/__snapshots__/agent-web-delete.test.js.snap +++ b/test/client_cli/en/__snapshots__/agent-web-delete.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/agent-web-describe.test.js.snap b/test/client_cli/en/__snapshots__/agent-web-describe.test.js.snap index b82e5ab1a..3ea0e00df 100644 --- a/test/client_cli/en/__snapshots__/agent-web-describe.test.js.snap +++ b/test/client_cli/en/__snapshots__/agent-web-describe.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/agent-web-export.test.js.snap b/test/client_cli/en/__snapshots__/agent-web-export.test.js.snap index 2a817336e..68e2d3650 100644 --- a/test/client_cli/en/__snapshots__/agent-web-export.test.js.snap +++ b/test/client_cli/en/__snapshots__/agent-web-export.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/agent-web-import.test.js.snap b/test/client_cli/en/__snapshots__/agent-web-import.test.js.snap index 4649f8318..68ae2a9af 100644 --- a/test/client_cli/en/__snapshots__/agent-web-import.test.js.snap +++ b/test/client_cli/en/__snapshots__/agent-web-import.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/agent-web-list.test.js.snap b/test/client_cli/en/__snapshots__/agent-web-list.test.js.snap index 5f1331447..0f4e2a56a 100644 --- a/test/client_cli/en/__snapshots__/agent-web-list.test.js.snap +++ b/test/client_cli/en/__snapshots__/agent-web-list.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/app-delete.test.js.snap b/test/client_cli/en/__snapshots__/app-delete.test.js.snap index 592f2d02d..d79c8506f 100644 --- a/test/client_cli/en/__snapshots__/app-delete.test.js.snap +++ b/test/client_cli/en/__snapshots__/app-delete.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/app-export.test.js.snap b/test/client_cli/en/__snapshots__/app-export.test.js.snap index 1de27341d..75c745060 100644 --- a/test/client_cli/en/__snapshots__/app-export.test.js.snap +++ b/test/client_cli/en/__snapshots__/app-export.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/app-import.test.js.snap b/test/client_cli/en/__snapshots__/app-import.test.js.snap index 0f4513e73..5740e88bf 100644 --- a/test/client_cli/en/__snapshots__/app-import.test.js.snap +++ b/test/client_cli/en/__snapshots__/app-import.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/app-list.test.js.snap b/test/client_cli/en/__snapshots__/app-list.test.js.snap index 5766b42f9..30d722880 100644 --- a/test/client_cli/en/__snapshots__/app-list.test.js.snap +++ b/test/client_cli/en/__snapshots__/app-list.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for @@ -109,7 +109,7 @@ Usage Examples:  $ frodo app list https://openam-matrix.id.forgerock.io/am thomas.anderson@metacortex.com 'Blu3P!ll3d'  List applications using a connection profile (identified by the full AM base URL):  $ frodo app list https://openam-matrix.id.forgerock.io/am - List applications using a connection profile (identified by a unique substring of the AM base URL): + List applications using a connection profile (identified by a unique substring of the AM base URL or a saved alias):  $ frodo app list matrix  " diff --git a/test/client_cli/en/__snapshots__/authn-describe.test.js.snap b/test/client_cli/en/__snapshots__/authn-describe.test.js.snap index 9529aeaca..02d8f9937 100644 --- a/test/client_cli/en/__snapshots__/authn-describe.test.js.snap +++ b/test/client_cli/en/__snapshots__/authn-describe.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/authn-export.test.js.snap b/test/client_cli/en/__snapshots__/authn-export.test.js.snap index a205c3e38..86ae63824 100644 --- a/test/client_cli/en/__snapshots__/authn-export.test.js.snap +++ b/test/client_cli/en/__snapshots__/authn-export.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/authn-import.test.js.snap b/test/client_cli/en/__snapshots__/authn-import.test.js.snap index e1bdc4073..2c33e17a1 100644 --- a/test/client_cli/en/__snapshots__/authn-import.test.js.snap +++ b/test/client_cli/en/__snapshots__/authn-import.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/authz-policy-delete.test.js.snap b/test/client_cli/en/__snapshots__/authz-policy-delete.test.js.snap index 744499154..51923cf4a 100644 --- a/test/client_cli/en/__snapshots__/authz-policy-delete.test.js.snap +++ b/test/client_cli/en/__snapshots__/authz-policy-delete.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/authz-policy-describe.test.js.snap b/test/client_cli/en/__snapshots__/authz-policy-describe.test.js.snap index a57f9a3f6..46b4cad99 100644 --- a/test/client_cli/en/__snapshots__/authz-policy-describe.test.js.snap +++ b/test/client_cli/en/__snapshots__/authz-policy-describe.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/authz-policy-export.test.js.snap b/test/client_cli/en/__snapshots__/authz-policy-export.test.js.snap index f574540ab..4eb524c6a 100644 --- a/test/client_cli/en/__snapshots__/authz-policy-export.test.js.snap +++ b/test/client_cli/en/__snapshots__/authz-policy-export.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/authz-policy-import.test.js.snap b/test/client_cli/en/__snapshots__/authz-policy-import.test.js.snap index 18ce5583e..893196381 100644 --- a/test/client_cli/en/__snapshots__/authz-policy-import.test.js.snap +++ b/test/client_cli/en/__snapshots__/authz-policy-import.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/authz-policy-list.test.js.snap b/test/client_cli/en/__snapshots__/authz-policy-list.test.js.snap index bf357cc9a..4b708ba7e 100644 --- a/test/client_cli/en/__snapshots__/authz-policy-list.test.js.snap +++ b/test/client_cli/en/__snapshots__/authz-policy-list.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/authz-set-delete.test.js.snap b/test/client_cli/en/__snapshots__/authz-set-delete.test.js.snap index 390602502..3fdc48cd1 100644 --- a/test/client_cli/en/__snapshots__/authz-set-delete.test.js.snap +++ b/test/client_cli/en/__snapshots__/authz-set-delete.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/authz-set-describe.test.js.snap b/test/client_cli/en/__snapshots__/authz-set-describe.test.js.snap index 7eb683e1e..3bf3eeb1c 100644 --- a/test/client_cli/en/__snapshots__/authz-set-describe.test.js.snap +++ b/test/client_cli/en/__snapshots__/authz-set-describe.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/authz-set-export.test.js.snap b/test/client_cli/en/__snapshots__/authz-set-export.test.js.snap index 073ee7c73..8cd900399 100644 --- a/test/client_cli/en/__snapshots__/authz-set-export.test.js.snap +++ b/test/client_cli/en/__snapshots__/authz-set-export.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/authz-set-import.test.js.snap b/test/client_cli/en/__snapshots__/authz-set-import.test.js.snap index ac611010f..836a2c476 100644 --- a/test/client_cli/en/__snapshots__/authz-set-import.test.js.snap +++ b/test/client_cli/en/__snapshots__/authz-set-import.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/authz-type-delete.test.js.snap b/test/client_cli/en/__snapshots__/authz-type-delete.test.js.snap index 9197713ce..5613c381a 100644 --- a/test/client_cli/en/__snapshots__/authz-type-delete.test.js.snap +++ b/test/client_cli/en/__snapshots__/authz-type-delete.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/authz-type-describe.test.js.snap b/test/client_cli/en/__snapshots__/authz-type-describe.test.js.snap index a372d1b2f..96b48e40f 100644 --- a/test/client_cli/en/__snapshots__/authz-type-describe.test.js.snap +++ b/test/client_cli/en/__snapshots__/authz-type-describe.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/authz-type-export.test.js.snap b/test/client_cli/en/__snapshots__/authz-type-export.test.js.snap index f1937ef7c..700961c8a 100644 --- a/test/client_cli/en/__snapshots__/authz-type-export.test.js.snap +++ b/test/client_cli/en/__snapshots__/authz-type-export.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/authz-type-import.test.js.snap b/test/client_cli/en/__snapshots__/authz-type-import.test.js.snap index b72e1a2ec..3497fd7bb 100644 --- a/test/client_cli/en/__snapshots__/authz-type-import.test.js.snap +++ b/test/client_cli/en/__snapshots__/authz-type-import.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/authz-type-list.test.js.snap b/test/client_cli/en/__snapshots__/authz-type-list.test.js.snap index d517950ce..d76d3e65f 100644 --- a/test/client_cli/en/__snapshots__/authz-type-list.test.js.snap +++ b/test/client_cli/en/__snapshots__/authz-type-list.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/config-export.test.js.snap b/test/client_cli/en/__snapshots__/config-export.test.js.snap index 4b7ffd871..bce0fd1f7 100644 --- a/test/client_cli/en/__snapshots__/config-export.test.js.snap +++ b/test/client_cli/en/__snapshots__/config-export.test.js.snap @@ -17,7 +17,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/config-import.test.js.snap b/test/client_cli/en/__snapshots__/config-import.test.js.snap index f1b55e7e6..32fe1bab0 100644 --- a/test/client_cli/en/__snapshots__/config-import.test.js.snap +++ b/test/client_cli/en/__snapshots__/config-import.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/conn-alias-add.test.js.snap b/test/client_cli/en/__snapshots__/conn-alias-add.test.js.snap new file mode 100644 index 000000000..6bf176cc2 --- /dev/null +++ b/test/client_cli/en/__snapshots__/conn-alias-add.test.js.snap @@ -0,0 +1,70 @@ +// Jest Snapshot v1, https://goo.gl/fbAQLP + +exports[`CLI help interface for 'conn alias' should be expected english 1`] = ` +"Usage: frodo conn alias add [options] [host] + +Add connection profile alias. + +Arguments: + alias Alias name for this connection profile. + host AM base URL, e.g.: + https://cdk.iam.example.com/am. To use a + connection profile, just specify a + unique substring or alias. + +Options: + -D, --directory Set the working directory. + --debug Debug output during command execution. + If specified, may or may not produce + additional output helpful for + troubleshooting. + --flush-cache Flush token cache. + -h, --help Help + --idm-host IDM base URL, e.g.: + https://cdk.idm.example.com/myidm. Use + only if your IDM installation resides in + a different domain and/or if the base + path differs from the default + "/openidm". + --login-client-id Specify a custom OAuth2 client id to use + a your own oauth2 client for IDM API + calls in deployments of type "cloud" or + "forgeops". Your custom client must be + configured as a public client and allow + the authorization code grant using the + "openid fr:idm:*" scope. Use the + "--redirect-uri" parameter if you have + configured a custom redirect uri + (default: + "/platform/appAuthHelperRedirect.html"). + --login-redirect-uri Specify a custom redirect URI to use + with your custom OAuth2 client (efault: + "/platform/appAuthHelperRedirect.html"). + --no-cache Disable token cache for this operation. + --sa-id Service account id. + --sa-jwk-file File containing the JSON Web Key (JWK) + associated with the the service account. + --verbose Verbose output during command execution. + If specified, may or may not produce + additional output. + +Environment Variables: + FRODO_HOST: AM base URL. Overridden by 'host' argument. + FRODO_IDM_HOST: IDM base URL. Overridden by '--idm-host' option. + FRODO_REALM: Realm. Overridden by 'realm' argument. + FRODO_USERNAME: Username. Overridden by 'username' argument. + FRODO_PASSWORD: Password. Overridden by 'password' argument. + FRODO_LOGIN_CLIENT_ID: OAuth2 client id for IDM API calls. Overridden by '--login-client-id' option. + FRODO_LOGIN_REDIRECT_URI: Redirect Uri for custom OAuth2 client id. Overridden by '--login-redirect-uri' option. + FRODO_SA_ID: Service account uuid. Overridden by '--sa-id' option. + FRODO_SA_JWK: Service account JWK. Overridden by '--sa-jwk-file' option but takes the actual JWK as a value, not a file name. + FRODO_NO_CACHE: Disable token cache. Same as '--no-cache' option. + FRODO_TOKEN_CACHE_PATH: Use this token cache file instead of '~/.frodo/TokenCache.json'. + FRODO_CONNECTION_PROFILES_PATH: Use this connection profiles file instead of '~/.frodo/Connections.json'. + FRODO_AUTHENTICATION_SERVICE: Name of a login journey to use. + FRODO_DEBUG: Set to any value to enable debug output. Same as '--debug'. + FRODO_MASTER_KEY_PATH: Use this master key file instead of '~/.frodo/masterkey.key' file. + FRODO_MASTER_KEY: Use this master key instead of what's in '~/.frodo/masterkey.key'. Takes precedence over FRODO_MASTER_KEY_PATH. + +" +`; diff --git a/test/client_cli/en/__snapshots__/conn-alias-delete.test.js.snap b/test/client_cli/en/__snapshots__/conn-alias-delete.test.js.snap new file mode 100644 index 000000000..75dd62ec2 --- /dev/null +++ b/test/client_cli/en/__snapshots__/conn-alias-delete.test.js.snap @@ -0,0 +1,69 @@ +// Jest Snapshot v1, https://goo.gl/fbAQLP + +exports[`CLI help interface for 'conn alias' should be expected english 1`] = ` +"Usage: frodo conn alias delete [options] [host] + +Delete connection profile alias. + +Arguments: + host AM base URL, e.g.: + https://cdk.iam.example.com/am. To use a + connection profile, just specify a + unique substring or alias. + +Options: + -D, --directory Set the working directory. + --debug Debug output during command execution. + If specified, may or may not produce + additional output helpful for + troubleshooting. + --flush-cache Flush token cache. + -h, --help Help + --idm-host IDM base URL, e.g.: + https://cdk.idm.example.com/myidm. Use + only if your IDM installation resides in + a different domain and/or if the base + path differs from the default + "/openidm". + --login-client-id Specify a custom OAuth2 client id to use + a your own oauth2 client for IDM API + calls in deployments of type "cloud" or + "forgeops". Your custom client must be + configured as a public client and allow + the authorization code grant using the + "openid fr:idm:*" scope. Use the + "--redirect-uri" parameter if you have + configured a custom redirect uri + (default: + "/platform/appAuthHelperRedirect.html"). + --login-redirect-uri Specify a custom redirect URI to use + with your custom OAuth2 client (efault: + "/platform/appAuthHelperRedirect.html"). + --no-cache Disable token cache for this operation. + --sa-id Service account id. + --sa-jwk-file File containing the JSON Web Key (JWK) + associated with the the service account. + --verbose Verbose output during command execution. + If specified, may or may not produce + additional output. + +Environment Variables: + FRODO_HOST: AM base URL. Overridden by 'host' argument. + FRODO_IDM_HOST: IDM base URL. Overridden by '--idm-host' option. + FRODO_REALM: Realm. Overridden by 'realm' argument. + FRODO_USERNAME: Username. Overridden by 'username' argument. + FRODO_PASSWORD: Password. Overridden by 'password' argument. + FRODO_LOGIN_CLIENT_ID: OAuth2 client id for IDM API calls. Overridden by '--login-client-id' option. + FRODO_LOGIN_REDIRECT_URI: Redirect Uri for custom OAuth2 client id. Overridden by '--login-redirect-uri' option. + FRODO_SA_ID: Service account uuid. Overridden by '--sa-id' option. + FRODO_SA_JWK: Service account JWK. Overridden by '--sa-jwk-file' option but takes the actual JWK as a value, not a file name. + FRODO_NO_CACHE: Disable token cache. Same as '--no-cache' option. + FRODO_TOKEN_CACHE_PATH: Use this token cache file instead of '~/.frodo/TokenCache.json'. + FRODO_CONNECTION_PROFILES_PATH: Use this connection profiles file instead of '~/.frodo/Connections.json'. + FRODO_AUTHENTICATION_SERVICE: Name of a login journey to use. + FRODO_DEBUG: Set to any value to enable debug output. Same as '--debug'. + FRODO_MASTER_KEY_PATH: Use this master key file instead of '~/.frodo/masterkey.key' file. + FRODO_MASTER_KEY: Use this master key instead of what's in '~/.frodo/masterkey.key'. Takes precedence over FRODO_MASTER_KEY_PATH. + +" +`; diff --git a/test/client_cli/en/__snapshots__/conn-alias.test.js.snap b/test/client_cli/en/__snapshots__/conn-alias.test.js.snap new file mode 100644 index 000000000..ee5ef085f --- /dev/null +++ b/test/client_cli/en/__snapshots__/conn-alias.test.js.snap @@ -0,0 +1,16 @@ +// Jest Snapshot v1, https://goo.gl/fbAQLP + +exports[`CLI help interface for 'conn alias' should be expected english 1`] = ` +"Usage: frodo conn alias [options] [command] + +Manage connection aliases. + +Options: + -h, --help Help + +Commands: + add Add connection profile alias. + delete Delete connection profile alias. + help display help for command +" +`; diff --git a/test/client_cli/en/__snapshots__/conn-delete.test.js.snap b/test/client_cli/en/__snapshots__/conn-delete.test.js.snap index 49e267b19..f2fc2e4ed 100644 --- a/test/client_cli/en/__snapshots__/conn-delete.test.js.snap +++ b/test/client_cli/en/__snapshots__/conn-delete.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. Options: -D, --directory Set the working directory. diff --git a/test/client_cli/en/__snapshots__/conn-describe.test.js.snap b/test/client_cli/en/__snapshots__/conn-describe.test.js.snap index af0d851d9..12b427845 100644 --- a/test/client_cli/en/__snapshots__/conn-describe.test.js.snap +++ b/test/client_cli/en/__snapshots__/conn-describe.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. Options: -D, --directory Set the working directory. diff --git a/test/client_cli/en/__snapshots__/conn-save.test.js.snap b/test/client_cli/en/__snapshots__/conn-save.test.js.snap index 6bc294566..ddcd7a056 100644 --- a/test/client_cli/en/__snapshots__/conn-save.test.js.snap +++ b/test/client_cli/en/__snapshots__/conn-save.test.js.snap @@ -6,11 +6,12 @@ exports[`CLI help interface for 'add' should be expected english 1`] = ` Save connection profiles. Arguments: - host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a unique substring. + host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. password Password. Options: + --alias [name] Alias name for this connection profile. --authentication-header-overrides [headers] Map of headers: {"host":"am.example.com:8081"}. --authentication-service [service] Name of the authentication service/tree to use. --curlirize Output all network calls in curl format. @@ -60,8 +61,12 @@ Environment Variables: Usage Examples: Create a connection profile with a new log API key and secret and a new service account:  $ frodo conn save https://openam-matrix.id.forgerock.io/am thomas.anderson@metacortex.com 'Blu3P!ll3d' + Create a connection profile with a new log API key and secret and a new service account and set an alias: + $ frodo conn save --alias MyConnection https://openam-matrix.id.forgerock.io/am thomas.anderson@metacortex.com 'Blu3P!ll3d'  Save an existing service account to an existing or new connection profile:  $ frodo conn save --sa-id b672336b-41ef-428d-ae4a-e0c082875377 --sa-jwk-file ./matrix-sa_privateKey.jwk https://openam-matrix.id.forgerock.io/am + Save an existing service account to an existing or new connection profile and set an alias: + $ frodo conn save --alias MyConnection --sa-id b672336b-41ef-428d-ae4a-e0c082875377 --sa-jwk-file ./matrix-sa_privateKey.jwk https://openam-matrix.id.forgerock.io/am  Save an existing service account to an existing connection profile (partial host URL only updates an existing profile):  $ frodo conn save --sa-id b672336b-41ef-428d-ae4a-e0c082875377 --sa-jwk-file ./matrix-sa_privateKey.jwk matrix  @@ -74,11 +79,12 @@ exports[`CLI help interface for 'add' should be expected english 2`] = ` Save connection profiles. Arguments: - host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a unique substring. + host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. password Password. Options: + --alias [name] Alias name for this connection profile. --authentication-header-overrides [headers] Map of headers: {"host":"am.example.com:8081"}. --authentication-service [service] Name of the authentication service/tree to use. --curlirize Output all network calls in curl format. @@ -128,8 +134,12 @@ Environment Variables: Usage Examples: Create a connection profile with a new log API key and secret and a new service account:  $ frodo conn save https://openam-matrix.id.forgerock.io/am thomas.anderson@metacortex.com 'Blu3P!ll3d' + Create a connection profile with a new log API key and secret and a new service account and set an alias: + $ frodo conn save --alias MyConnection https://openam-matrix.id.forgerock.io/am thomas.anderson@metacortex.com 'Blu3P!ll3d'  Save an existing service account to an existing or new connection profile:  $ frodo conn save --sa-id b672336b-41ef-428d-ae4a-e0c082875377 --sa-jwk-file ./matrix-sa_privateKey.jwk https://openam-matrix.id.forgerock.io/am + Save an existing service account to an existing or new connection profile and set an alias: + $ frodo conn save --alias MyConnection --sa-id b672336b-41ef-428d-ae4a-e0c082875377 --sa-jwk-file ./matrix-sa_privateKey.jwk https://openam-matrix.id.forgerock.io/am  Save an existing service account to an existing connection profile (partial host URL only updates an existing profile):  $ frodo conn save --sa-id b672336b-41ef-428d-ae4a-e0c082875377 --sa-jwk-file ./matrix-sa_privateKey.jwk matrix  @@ -142,11 +152,12 @@ exports[`CLI help interface for 'save' should be expected english 1`] = ` Save connection profiles. Arguments: - host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a unique substring. + host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. password Password. Options: + --alias [name] Alias name for this connection profile. --authentication-header-overrides [headers] Map of headers: {"host":"am.example.com:8081"}. --authentication-service [service] Name of the authentication service/tree to use. --curlirize Output all network calls in curl format. @@ -196,8 +207,12 @@ Environment Variables: Usage Examples: Create a connection profile with a new log API key and secret and a new service account:  $ frodo conn save https://openam-matrix.id.forgerock.io/am thomas.anderson@metacortex.com 'Blu3P!ll3d' + Create a connection profile with a new log API key and secret and a new service account and set an alias: + $ frodo conn save --alias MyConnection https://openam-matrix.id.forgerock.io/am thomas.anderson@metacortex.com 'Blu3P!ll3d'  Save an existing service account to an existing or new connection profile:  $ frodo conn save --sa-id b672336b-41ef-428d-ae4a-e0c082875377 --sa-jwk-file ./matrix-sa_privateKey.jwk https://openam-matrix.id.forgerock.io/am + Save an existing service account to an existing or new connection profile and set an alias: + $ frodo conn save --alias MyConnection --sa-id b672336b-41ef-428d-ae4a-e0c082875377 --sa-jwk-file ./matrix-sa_privateKey.jwk https://openam-matrix.id.forgerock.io/am  Save an existing service account to an existing connection profile (partial host URL only updates an existing profile):  $ frodo conn save --sa-id b672336b-41ef-428d-ae4a-e0c082875377 --sa-jwk-file ./matrix-sa_privateKey.jwk matrix  @@ -210,11 +225,12 @@ exports[`CLI help interface for 'save' should be expected english 2`] = ` Save connection profiles. Arguments: - host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a unique substring. + host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. password Password. Options: + --alias [name] Alias name for this connection profile. --authentication-header-overrides [headers] Map of headers: {"host":"am.example.com:8081"}. --authentication-service [service] Name of the authentication service/tree to use. --curlirize Output all network calls in curl format. @@ -264,8 +280,12 @@ Environment Variables: Usage Examples: Create a connection profile with a new log API key and secret and a new service account:  $ frodo conn save https://openam-matrix.id.forgerock.io/am thomas.anderson@metacortex.com 'Blu3P!ll3d' + Create a connection profile with a new log API key and secret and a new service account and set an alias: + $ frodo conn save --alias MyConnection https://openam-matrix.id.forgerock.io/am thomas.anderson@metacortex.com 'Blu3P!ll3d'  Save an existing service account to an existing or new connection profile:  $ frodo conn save --sa-id b672336b-41ef-428d-ae4a-e0c082875377 --sa-jwk-file ./matrix-sa_privateKey.jwk https://openam-matrix.id.forgerock.io/am + Save an existing service account to an existing or new connection profile and set an alias: + $ frodo conn save --alias MyConnection --sa-id b672336b-41ef-428d-ae4a-e0c082875377 --sa-jwk-file ./matrix-sa_privateKey.jwk https://openam-matrix.id.forgerock.io/am  Save an existing service account to an existing connection profile (partial host URL only updates an existing profile):  $ frodo conn save --sa-id b672336b-41ef-428d-ae4a-e0c082875377 --sa-jwk-file ./matrix-sa_privateKey.jwk matrix  diff --git a/test/client_cli/en/__snapshots__/conn.test.js.snap b/test/client_cli/en/__snapshots__/conn.test.js.snap index 28fdb9984..4c969b2c7 100644 --- a/test/client_cli/en/__snapshots__/conn.test.js.snap +++ b/test/client_cli/en/__snapshots__/conn.test.js.snap @@ -9,6 +9,7 @@ Options: -h, --help Help Commands: + alias Manage connection aliases. delete Delete connection profiles. describe Describe connection profile. help display help for command diff --git a/test/client_cli/en/__snapshots__/email-template-export.test.js.snap b/test/client_cli/en/__snapshots__/email-template-export.test.js.snap index 3053f1191..e5ae1f6a2 100644 --- a/test/client_cli/en/__snapshots__/email-template-export.test.js.snap +++ b/test/client_cli/en/__snapshots__/email-template-export.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/email-template-import.test.js.snap b/test/client_cli/en/__snapshots__/email-template-import.test.js.snap index 3ec645b61..35cde86ef 100644 --- a/test/client_cli/en/__snapshots__/email-template-import.test.js.snap +++ b/test/client_cli/en/__snapshots__/email-template-import.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/email-template-list.test.js.snap b/test/client_cli/en/__snapshots__/email-template-list.test.js.snap index 190cab019..08fb8ef89 100644 --- a/test/client_cli/en/__snapshots__/email-template-list.test.js.snap +++ b/test/client_cli/en/__snapshots__/email-template-list.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/esv-apply.test.js.snap b/test/client_cli/en/__snapshots__/esv-apply.test.js.snap index 65ed568a1..9d6349e3c 100644 --- a/test/client_cli/en/__snapshots__/esv-apply.test.js.snap +++ b/test/client_cli/en/__snapshots__/esv-apply.test.js.snap @@ -11,7 +11,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. diff --git a/test/client_cli/en/__snapshots__/esv-secret-create.test.js.snap b/test/client_cli/en/__snapshots__/esv-secret-create.test.js.snap index 9c4f96b97..9c8c89690 100644 --- a/test/client_cli/en/__snapshots__/esv-secret-create.test.js.snap +++ b/test/client_cli/en/__snapshots__/esv-secret-create.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. diff --git a/test/client_cli/en/__snapshots__/esv-secret-delete.test.js.snap b/test/client_cli/en/__snapshots__/esv-secret-delete.test.js.snap index 9720ca71d..82b57a590 100644 --- a/test/client_cli/en/__snapshots__/esv-secret-delete.test.js.snap +++ b/test/client_cli/en/__snapshots__/esv-secret-delete.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. diff --git a/test/client_cli/en/__snapshots__/esv-secret-describe.test.js.snap b/test/client_cli/en/__snapshots__/esv-secret-describe.test.js.snap index 5629e72e7..271bb0039 100644 --- a/test/client_cli/en/__snapshots__/esv-secret-describe.test.js.snap +++ b/test/client_cli/en/__snapshots__/esv-secret-describe.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. diff --git a/test/client_cli/en/__snapshots__/esv-secret-export.test.js.snap b/test/client_cli/en/__snapshots__/esv-secret-export.test.js.snap index 6f5f6cce3..c00c19ab4 100644 --- a/test/client_cli/en/__snapshots__/esv-secret-export.test.js.snap +++ b/test/client_cli/en/__snapshots__/esv-secret-export.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. diff --git a/test/client_cli/en/__snapshots__/esv-secret-import.test.js.snap b/test/client_cli/en/__snapshots__/esv-secret-import.test.js.snap index 6a790b0dc..7040c4a0b 100644 --- a/test/client_cli/en/__snapshots__/esv-secret-import.test.js.snap +++ b/test/client_cli/en/__snapshots__/esv-secret-import.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. diff --git a/test/client_cli/en/__snapshots__/esv-secret-list.test.js.snap b/test/client_cli/en/__snapshots__/esv-secret-list.test.js.snap index 20dc280b3..4347eadc5 100644 --- a/test/client_cli/en/__snapshots__/esv-secret-list.test.js.snap +++ b/test/client_cli/en/__snapshots__/esv-secret-list.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. diff --git a/test/client_cli/en/__snapshots__/esv-secret-set.test.js.snap b/test/client_cli/en/__snapshots__/esv-secret-set.test.js.snap index 441356f70..9b5d99a28 100644 --- a/test/client_cli/en/__snapshots__/esv-secret-set.test.js.snap +++ b/test/client_cli/en/__snapshots__/esv-secret-set.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. diff --git a/test/client_cli/en/__snapshots__/esv-secret-version-activate.test.js.snap b/test/client_cli/en/__snapshots__/esv-secret-version-activate.test.js.snap index f14c2bbff..220cefe69 100644 --- a/test/client_cli/en/__snapshots__/esv-secret-version-activate.test.js.snap +++ b/test/client_cli/en/__snapshots__/esv-secret-version-activate.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. diff --git a/test/client_cli/en/__snapshots__/esv-secret-version-create.test.js.snap b/test/client_cli/en/__snapshots__/esv-secret-version-create.test.js.snap index 53f96e356..d551df2d9 100644 --- a/test/client_cli/en/__snapshots__/esv-secret-version-create.test.js.snap +++ b/test/client_cli/en/__snapshots__/esv-secret-version-create.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. diff --git a/test/client_cli/en/__snapshots__/esv-secret-version-deactivate.test.js.snap b/test/client_cli/en/__snapshots__/esv-secret-version-deactivate.test.js.snap index 51a18724f..e2414e35a 100644 --- a/test/client_cli/en/__snapshots__/esv-secret-version-deactivate.test.js.snap +++ b/test/client_cli/en/__snapshots__/esv-secret-version-deactivate.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. diff --git a/test/client_cli/en/__snapshots__/esv-secret-version-delete.test.js.snap b/test/client_cli/en/__snapshots__/esv-secret-version-delete.test.js.snap index b1fbc393e..2af361aaf 100644 --- a/test/client_cli/en/__snapshots__/esv-secret-version-delete.test.js.snap +++ b/test/client_cli/en/__snapshots__/esv-secret-version-delete.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. diff --git a/test/client_cli/en/__snapshots__/esv-secret-version-list.test.js.snap b/test/client_cli/en/__snapshots__/esv-secret-version-list.test.js.snap index 839962660..14100c431 100644 --- a/test/client_cli/en/__snapshots__/esv-secret-version-list.test.js.snap +++ b/test/client_cli/en/__snapshots__/esv-secret-version-list.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. diff --git a/test/client_cli/en/__snapshots__/esv-variable-create.test.js.snap b/test/client_cli/en/__snapshots__/esv-variable-create.test.js.snap index 57774a259..ed65de022 100644 --- a/test/client_cli/en/__snapshots__/esv-variable-create.test.js.snap +++ b/test/client_cli/en/__snapshots__/esv-variable-create.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. diff --git a/test/client_cli/en/__snapshots__/esv-variable-delete.test.js.snap b/test/client_cli/en/__snapshots__/esv-variable-delete.test.js.snap index bcf382eb6..9f5d0e868 100644 --- a/test/client_cli/en/__snapshots__/esv-variable-delete.test.js.snap +++ b/test/client_cli/en/__snapshots__/esv-variable-delete.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. diff --git a/test/client_cli/en/__snapshots__/esv-variable-describe.test.js.snap b/test/client_cli/en/__snapshots__/esv-variable-describe.test.js.snap index e3bfa6d47..706e024c3 100644 --- a/test/client_cli/en/__snapshots__/esv-variable-describe.test.js.snap +++ b/test/client_cli/en/__snapshots__/esv-variable-describe.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. diff --git a/test/client_cli/en/__snapshots__/esv-variable-export.test.js.snap b/test/client_cli/en/__snapshots__/esv-variable-export.test.js.snap index 2e01d8792..f56efe6a4 100644 --- a/test/client_cli/en/__snapshots__/esv-variable-export.test.js.snap +++ b/test/client_cli/en/__snapshots__/esv-variable-export.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. diff --git a/test/client_cli/en/__snapshots__/esv-variable-import.test.js.snap b/test/client_cli/en/__snapshots__/esv-variable-import.test.js.snap index 4727ab958..e0609384c 100644 --- a/test/client_cli/en/__snapshots__/esv-variable-import.test.js.snap +++ b/test/client_cli/en/__snapshots__/esv-variable-import.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. diff --git a/test/client_cli/en/__snapshots__/esv-variable-list.test.js.snap b/test/client_cli/en/__snapshots__/esv-variable-list.test.js.snap index f40191719..04de13366 100644 --- a/test/client_cli/en/__snapshots__/esv-variable-list.test.js.snap +++ b/test/client_cli/en/__snapshots__/esv-variable-list.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. diff --git a/test/client_cli/en/__snapshots__/esv-variable-set.test.js.snap b/test/client_cli/en/__snapshots__/esv-variable-set.test.js.snap index 8237a6b6f..a78294f1f 100644 --- a/test/client_cli/en/__snapshots__/esv-variable-set.test.js.snap +++ b/test/client_cli/en/__snapshots__/esv-variable-set.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. diff --git a/test/client_cli/en/__snapshots__/idm-count.test.js.snap b/test/client_cli/en/__snapshots__/idm-count.test.js.snap index 1ceeb4636..a1c5ef733 100644 --- a/test/client_cli/en/__snapshots__/idm-count.test.js.snap +++ b/test/client_cli/en/__snapshots__/idm-count.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/idm-delete.test.js.snap b/test/client_cli/en/__snapshots__/idm-delete.test.js.snap index aaecb77aa..e29593a5a 100644 --- a/test/client_cli/en/__snapshots__/idm-delete.test.js.snap +++ b/test/client_cli/en/__snapshots__/idm-delete.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/idm-export.test.js.snap b/test/client_cli/en/__snapshots__/idm-export.test.js.snap index da40cbe0c..b61e5faee 100644 --- a/test/client_cli/en/__snapshots__/idm-export.test.js.snap +++ b/test/client_cli/en/__snapshots__/idm-export.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/idm-import.test.js.snap b/test/client_cli/en/__snapshots__/idm-import.test.js.snap index 2365775c9..4fcc52f0b 100644 --- a/test/client_cli/en/__snapshots__/idm-import.test.js.snap +++ b/test/client_cli/en/__snapshots__/idm-import.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/idm-list.test.js.snap b/test/client_cli/en/__snapshots__/idm-list.test.js.snap index 91a77306a..fc22ff1ee 100644 --- a/test/client_cli/en/__snapshots__/idm-list.test.js.snap +++ b/test/client_cli/en/__snapshots__/idm-list.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/idm-schema-object-export.test.js.snap b/test/client_cli/en/__snapshots__/idm-schema-object-export.test.js.snap index 4ec904db0..5085b22dc 100644 --- a/test/client_cli/en/__snapshots__/idm-schema-object-export.test.js.snap +++ b/test/client_cli/en/__snapshots__/idm-schema-object-export.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/idm-schema-object-import.test.js.snap b/test/client_cli/en/__snapshots__/idm-schema-object-import.test.js.snap index 4ec904db0..5085b22dc 100644 --- a/test/client_cli/en/__snapshots__/idm-schema-object-import.test.js.snap +++ b/test/client_cli/en/__snapshots__/idm-schema-object-import.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/idp-delete.test.js.snap b/test/client_cli/en/__snapshots__/idp-delete.test.js.snap index 99b7a467a..ae514f761 100644 --- a/test/client_cli/en/__snapshots__/idp-delete.test.js.snap +++ b/test/client_cli/en/__snapshots__/idp-delete.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/idp-export.test.js.snap b/test/client_cli/en/__snapshots__/idp-export.test.js.snap index bb57f882f..53e31a706 100644 --- a/test/client_cli/en/__snapshots__/idp-export.test.js.snap +++ b/test/client_cli/en/__snapshots__/idp-export.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/idp-import.test.js.snap b/test/client_cli/en/__snapshots__/idp-import.test.js.snap index 6c4130b49..44ca493a0 100644 --- a/test/client_cli/en/__snapshots__/idp-import.test.js.snap +++ b/test/client_cli/en/__snapshots__/idp-import.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/idp-list.test.js.snap b/test/client_cli/en/__snapshots__/idp-list.test.js.snap index 72135d594..2a4326d2d 100644 --- a/test/client_cli/en/__snapshots__/idp-list.test.js.snap +++ b/test/client_cli/en/__snapshots__/idp-list.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/info.test.js.snap b/test/client_cli/en/__snapshots__/info.test.js.snap index 7b378eb21..494468eff 100644 --- a/test/client_cli/en/__snapshots__/info.test.js.snap +++ b/test/client_cli/en/__snapshots__/info.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. @@ -101,9 +101,9 @@ Usage Examples:  $ frodo info https://openam-matrix.id.forgerock.io/am thomas.anderson@metacortex.com 'Blu3P!ll3d'  Show human-readable output and login using a connection profile (identified by the full AM base URL):  $ frodo info https://openam-matrix.id.forgerock.io/am - Show human-readable output and login using a connection profile (identified by a unique substring of the AM base URL): + Show human-readable output and login using a connection profile (identified by a unique substring of the AM base URL or a saved alias):  $ frodo info matrix - Show JSON output and login using the AM base URL's unique substring to identify the connection profile: + Show JSON output and login using the AM base URL's unique substring or a saved alias to identify the connection profile:  $ frodo info --json matrix  " diff --git a/test/client_cli/en/__snapshots__/journey-delete.test.js.snap b/test/client_cli/en/__snapshots__/journey-delete.test.js.snap index 8645489e1..b0d8832ec 100644 --- a/test/client_cli/en/__snapshots__/journey-delete.test.js.snap +++ b/test/client_cli/en/__snapshots__/journey-delete.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/journey-describe.test.js.snap b/test/client_cli/en/__snapshots__/journey-describe.test.js.snap index 2be83270d..38f197564 100644 --- a/test/client_cli/en/__snapshots__/journey-describe.test.js.snap +++ b/test/client_cli/en/__snapshots__/journey-describe.test.js.snap @@ -11,7 +11,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/journey-disable.test.js.snap b/test/client_cli/en/__snapshots__/journey-disable.test.js.snap index 90bbd60d2..15957b342 100644 --- a/test/client_cli/en/__snapshots__/journey-disable.test.js.snap +++ b/test/client_cli/en/__snapshots__/journey-disable.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/journey-enable.test.js.snap b/test/client_cli/en/__snapshots__/journey-enable.test.js.snap index c0dd964b2..b937d5a9e 100644 --- a/test/client_cli/en/__snapshots__/journey-enable.test.js.snap +++ b/test/client_cli/en/__snapshots__/journey-enable.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/journey-export.test.js.snap b/test/client_cli/en/__snapshots__/journey-export.test.js.snap index c17a8d94e..84823941b 100644 --- a/test/client_cli/en/__snapshots__/journey-export.test.js.snap +++ b/test/client_cli/en/__snapshots__/journey-export.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/journey-import.test.js.snap b/test/client_cli/en/__snapshots__/journey-import.test.js.snap index 4047dc74b..2740b9517 100644 --- a/test/client_cli/en/__snapshots__/journey-import.test.js.snap +++ b/test/client_cli/en/__snapshots__/journey-import.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/journey-list.test.js.snap b/test/client_cli/en/__snapshots__/journey-list.test.js.snap index e9579d4e2..8df7a0ad2 100644 --- a/test/client_cli/en/__snapshots__/journey-list.test.js.snap +++ b/test/client_cli/en/__snapshots__/journey-list.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/journey-prune.test.js.snap b/test/client_cli/en/__snapshots__/journey-prune.test.js.snap index 7e657abbc..f25ba6080 100644 --- a/test/client_cli/en/__snapshots__/journey-prune.test.js.snap +++ b/test/client_cli/en/__snapshots__/journey-prune.test.js.snap @@ -11,7 +11,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/log-fetch.test.js.snap b/test/client_cli/en/__snapshots__/log-fetch.test.js.snap index 378545575..1c58abf1b 100644 --- a/test/client_cli/en/__snapshots__/log-fetch.test.js.snap +++ b/test/client_cli/en/__snapshots__/log-fetch.test.js.snap @@ -11,7 +11,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. @@ -139,7 +139,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. diff --git a/test/client_cli/en/__snapshots__/log-list.test.js.snap b/test/client_cli/en/__snapshots__/log-list.test.js.snap index b869cc629..7b4a21bb3 100644 --- a/test/client_cli/en/__snapshots__/log-list.test.js.snap +++ b/test/client_cli/en/__snapshots__/log-list.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. @@ -109,7 +109,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. diff --git a/test/client_cli/en/__snapshots__/log-tail.test.js.snap b/test/client_cli/en/__snapshots__/log-tail.test.js.snap index 1385dd60e..d0628011e 100644 --- a/test/client_cli/en/__snapshots__/log-tail.test.js.snap +++ b/test/client_cli/en/__snapshots__/log-tail.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. @@ -125,7 +125,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. diff --git a/test/client_cli/en/__snapshots__/mapping-delete.test.js.snap b/test/client_cli/en/__snapshots__/mapping-delete.test.js.snap index 0711bcf73..795593906 100644 --- a/test/client_cli/en/__snapshots__/mapping-delete.test.js.snap +++ b/test/client_cli/en/__snapshots__/mapping-delete.test.js.snap @@ -6,7 +6,7 @@ exports[`CLI help interface for 'mapping delete' should be expected english 1`] Delete IDM mappings. Arguments: - host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a unique substring. + host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for Identity Cloud tenants, "/" otherwise.) username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. password Password. diff --git a/test/client_cli/en/__snapshots__/mapping-export.test.js.snap b/test/client_cli/en/__snapshots__/mapping-export.test.js.snap index 065a57e9d..de36d356d 100644 --- a/test/client_cli/en/__snapshots__/mapping-export.test.js.snap +++ b/test/client_cli/en/__snapshots__/mapping-export.test.js.snap @@ -6,7 +6,7 @@ exports[`CLI help interface for 'mapping export' should be expected english 1`] Export IDM mappings. Arguments: - host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a unique substring. + host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for Identity Cloud tenants, "/" otherwise.) username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. password Password. diff --git a/test/client_cli/en/__snapshots__/mapping-import.test.js.snap b/test/client_cli/en/__snapshots__/mapping-import.test.js.snap index c83159977..4448a28e2 100644 --- a/test/client_cli/en/__snapshots__/mapping-import.test.js.snap +++ b/test/client_cli/en/__snapshots__/mapping-import.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/mapping-list.test.js.snap b/test/client_cli/en/__snapshots__/mapping-list.test.js.snap index fa6581dab..16245c7fb 100644 --- a/test/client_cli/en/__snapshots__/mapping-list.test.js.snap +++ b/test/client_cli/en/__snapshots__/mapping-list.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/mapping-rename.test.js.snap b/test/client_cli/en/__snapshots__/mapping-rename.test.js.snap index 8450139b9..f6058ba6a 100644 --- a/test/client_cli/en/__snapshots__/mapping-rename.test.js.snap +++ b/test/client_cli/en/__snapshots__/mapping-rename.test.js.snap @@ -11,7 +11,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/oauth-client-delete.test.js.snap b/test/client_cli/en/__snapshots__/oauth-client-delete.test.js.snap index f4643f35a..ed3e2dd3b 100644 --- a/test/client_cli/en/__snapshots__/oauth-client-delete.test.js.snap +++ b/test/client_cli/en/__snapshots__/oauth-client-delete.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/oauth-client-export.test.js.snap b/test/client_cli/en/__snapshots__/oauth-client-export.test.js.snap index 10e8aa7f7..d2a9eedd2 100644 --- a/test/client_cli/en/__snapshots__/oauth-client-export.test.js.snap +++ b/test/client_cli/en/__snapshots__/oauth-client-export.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/oauth-client-import.test.js.snap b/test/client_cli/en/__snapshots__/oauth-client-import.test.js.snap index 0439dc5a6..1e540c07a 100644 --- a/test/client_cli/en/__snapshots__/oauth-client-import.test.js.snap +++ b/test/client_cli/en/__snapshots__/oauth-client-import.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/oauth-client-list.test.js.snap b/test/client_cli/en/__snapshots__/oauth-client-list.test.js.snap index de5402261..de8a4b05f 100644 --- a/test/client_cli/en/__snapshots__/oauth-client-list.test.js.snap +++ b/test/client_cli/en/__snapshots__/oauth-client-list.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/promote.test.js.snap b/test/client_cli/en/__snapshots__/promote.test.js.snap index 2f5865035..6ff479a25 100644 --- a/test/client_cli/en/__snapshots__/promote.test.js.snap +++ b/test/client_cli/en/__snapshots__/promote.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/realm-add-custom-domain.test.js.snap b/test/client_cli/en/__snapshots__/realm-add-custom-domain.test.js.snap index 0fda55a2e..fd1398cd0 100644 --- a/test/client_cli/en/__snapshots__/realm-add-custom-domain.test.js.snap +++ b/test/client_cli/en/__snapshots__/realm-add-custom-domain.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/realm-describe.test.js.snap b/test/client_cli/en/__snapshots__/realm-describe.test.js.snap index 05ef9d0d8..7533d9c35 100644 --- a/test/client_cli/en/__snapshots__/realm-describe.test.js.snap +++ b/test/client_cli/en/__snapshots__/realm-describe.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/realm-export.test.js.snap b/test/client_cli/en/__snapshots__/realm-export.test.js.snap index b59a2ef07..2fd58ba0c 100644 --- a/test/client_cli/en/__snapshots__/realm-export.test.js.snap +++ b/test/client_cli/en/__snapshots__/realm-export.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/realm-import.test.js.snap b/test/client_cli/en/__snapshots__/realm-import.test.js.snap index 686b58f2b..dbef29fe2 100644 --- a/test/client_cli/en/__snapshots__/realm-import.test.js.snap +++ b/test/client_cli/en/__snapshots__/realm-import.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/realm-list.test.js.snap b/test/client_cli/en/__snapshots__/realm-list.test.js.snap index a1effb3ea..8ac0bb641 100644 --- a/test/client_cli/en/__snapshots__/realm-list.test.js.snap +++ b/test/client_cli/en/__snapshots__/realm-list.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/realm-remove-custom-domain.test.js.snap b/test/client_cli/en/__snapshots__/realm-remove-custom-domain.test.js.snap index e3af3148b..16de87312 100644 --- a/test/client_cli/en/__snapshots__/realm-remove-custom-domain.test.js.snap +++ b/test/client_cli/en/__snapshots__/realm-remove-custom-domain.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/role-export.test.js.snap b/test/client_cli/en/__snapshots__/role-export.test.js.snap index 6a59049ee..c39695ef7 100644 --- a/test/client_cli/en/__snapshots__/role-export.test.js.snap +++ b/test/client_cli/en/__snapshots__/role-export.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/role-import.test.js.snap b/test/client_cli/en/__snapshots__/role-import.test.js.snap index 67196159f..0cb76fc5b 100644 --- a/test/client_cli/en/__snapshots__/role-import.test.js.snap +++ b/test/client_cli/en/__snapshots__/role-import.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/role-list.test.js.snap b/test/client_cli/en/__snapshots__/role-list.test.js.snap index e97092410..727751f43 100644 --- a/test/client_cli/en/__snapshots__/role-list.test.js.snap +++ b/test/client_cli/en/__snapshots__/role-list.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/saml-cot-export.test.js.snap b/test/client_cli/en/__snapshots__/saml-cot-export.test.js.snap index 0d46a2a79..ae65ee90a 100644 --- a/test/client_cli/en/__snapshots__/saml-cot-export.test.js.snap +++ b/test/client_cli/en/__snapshots__/saml-cot-export.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/saml-cot-import.test.js.snap b/test/client_cli/en/__snapshots__/saml-cot-import.test.js.snap index dc88c059e..6cec86a71 100644 --- a/test/client_cli/en/__snapshots__/saml-cot-import.test.js.snap +++ b/test/client_cli/en/__snapshots__/saml-cot-import.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/saml-cot-list.test.js.snap b/test/client_cli/en/__snapshots__/saml-cot-list.test.js.snap index 86559f430..a7cb90843 100644 --- a/test/client_cli/en/__snapshots__/saml-cot-list.test.js.snap +++ b/test/client_cli/en/__snapshots__/saml-cot-list.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/saml-delete.test.js.snap b/test/client_cli/en/__snapshots__/saml-delete.test.js.snap index 0b4754f19..291affba4 100644 --- a/test/client_cli/en/__snapshots__/saml-delete.test.js.snap +++ b/test/client_cli/en/__snapshots__/saml-delete.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/saml-describe.test.js.snap b/test/client_cli/en/__snapshots__/saml-describe.test.js.snap index 5623e1014..b0e432808 100644 --- a/test/client_cli/en/__snapshots__/saml-describe.test.js.snap +++ b/test/client_cli/en/__snapshots__/saml-describe.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/saml-export.test.js.snap b/test/client_cli/en/__snapshots__/saml-export.test.js.snap index 5056f3887..878a17c35 100644 --- a/test/client_cli/en/__snapshots__/saml-export.test.js.snap +++ b/test/client_cli/en/__snapshots__/saml-export.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/saml-import.test.js.snap b/test/client_cli/en/__snapshots__/saml-import.test.js.snap index b1192f2ef..a7703393d 100644 --- a/test/client_cli/en/__snapshots__/saml-import.test.js.snap +++ b/test/client_cli/en/__snapshots__/saml-import.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/saml-list.test.js.snap b/test/client_cli/en/__snapshots__/saml-list.test.js.snap index 5b944cc3f..37d61ca02 100644 --- a/test/client_cli/en/__snapshots__/saml-list.test.js.snap +++ b/test/client_cli/en/__snapshots__/saml-list.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/saml-metadata-export.test.js.snap b/test/client_cli/en/__snapshots__/saml-metadata-export.test.js.snap index c19a1d519..31f963f88 100644 --- a/test/client_cli/en/__snapshots__/saml-metadata-export.test.js.snap +++ b/test/client_cli/en/__snapshots__/saml-metadata-export.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/script-delete.test.js.snap b/test/client_cli/en/__snapshots__/script-delete.test.js.snap index 182e76faf..098318932 100644 --- a/test/client_cli/en/__snapshots__/script-delete.test.js.snap +++ b/test/client_cli/en/__snapshots__/script-delete.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/script-describe.test.js.snap b/test/client_cli/en/__snapshots__/script-describe.test.js.snap index a7a5432a4..b3fb89d3e 100644 --- a/test/client_cli/en/__snapshots__/script-describe.test.js.snap +++ b/test/client_cli/en/__snapshots__/script-describe.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/script-export.test.js.snap b/test/client_cli/en/__snapshots__/script-export.test.js.snap index fd16724a3..98e7db869 100644 --- a/test/client_cli/en/__snapshots__/script-export.test.js.snap +++ b/test/client_cli/en/__snapshots__/script-export.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/script-import.test.js.snap b/test/client_cli/en/__snapshots__/script-import.test.js.snap index 72cd828da..0570700be 100644 --- a/test/client_cli/en/__snapshots__/script-import.test.js.snap +++ b/test/client_cli/en/__snapshots__/script-import.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/script-list.test.js.snap b/test/client_cli/en/__snapshots__/script-list.test.js.snap index bf3dc5c33..045bbb446 100644 --- a/test/client_cli/en/__snapshots__/script-list.test.js.snap +++ b/test/client_cli/en/__snapshots__/script-list.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/server-export.test.js.snap b/test/client_cli/en/__snapshots__/server-export.test.js.snap index 9d2d44c20..8b8a869a9 100644 --- a/test/client_cli/en/__snapshots__/server-export.test.js.snap +++ b/test/client_cli/en/__snapshots__/server-export.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for @@ -92,9 +92,9 @@ Options: associated with the the service account. -u, --server-url Server url. Can be a unique substring of the full url (if not unique, it will - error out). If specified, only one - server is exported and the options -a - and -A are ignored. + error out) or a saved alias. If + specified, only one server is exported + and the options -a and -A are ignored. --verbose Verbose output during command execution. If specified, may or may not produce additional output. diff --git a/test/client_cli/en/__snapshots__/server-import.test.js.snap b/test/client_cli/en/__snapshots__/server-import.test.js.snap index 388103399..1fafe4173 100644 --- a/test/client_cli/en/__snapshots__/server-import.test.js.snap +++ b/test/client_cli/en/__snapshots__/server-import.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for @@ -90,9 +90,9 @@ Options: associated with the the service account. -u, --server-url Server url. Can be a unique substring of the full url (if not unique, it will - error out). If specified, only one - server is imported and the options -a - and -A are ignored. + error out) or a saved alias. If + specified, only one server is imported + and the options -a and -A are ignored. --verbose Verbose output during command execution. If specified, may or may not produce additional output. diff --git a/test/client_cli/en/__snapshots__/server-list.test.js.snap b/test/client_cli/en/__snapshots__/server-list.test.js.snap index 4e4679fb6..aaa166a71 100644 --- a/test/client_cli/en/__snapshots__/server-list.test.js.snap +++ b/test/client_cli/en/__snapshots__/server-list.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/service-delete.test.js.snap b/test/client_cli/en/__snapshots__/service-delete.test.js.snap index f56b7f63f..5b2a1a86c 100644 --- a/test/client_cli/en/__snapshots__/service-delete.test.js.snap +++ b/test/client_cli/en/__snapshots__/service-delete.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/service-export.test.js.snap b/test/client_cli/en/__snapshots__/service-export.test.js.snap index 3adbd1f42..3dfc1ebcc 100644 --- a/test/client_cli/en/__snapshots__/service-export.test.js.snap +++ b/test/client_cli/en/__snapshots__/service-export.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/service-import.test.js.snap b/test/client_cli/en/__snapshots__/service-import.test.js.snap index 19ff14e5c..003e04289 100644 --- a/test/client_cli/en/__snapshots__/service-import.test.js.snap +++ b/test/client_cli/en/__snapshots__/service-import.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/service-list.test.js.snap b/test/client_cli/en/__snapshots__/service-list.test.js.snap index 5b2754504..f0cedacb6 100644 --- a/test/client_cli/en/__snapshots__/service-list.test.js.snap +++ b/test/client_cli/en/__snapshots__/service-list.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/shell.test.js.snap b/test/client_cli/en/__snapshots__/shell.test.js.snap index 93a19e872..c7c3caa7b 100644 --- a/test/client_cli/en/__snapshots__/shell.test.js.snap +++ b/test/client_cli/en/__snapshots__/shell.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for @@ -106,7 +106,7 @@ Usage Examples:  $ frodo shell https://openam-matrix.id.forgerock.io/am /alpha thomas.anderson@metacortex.com 'Blu3P!ll3d'  Launch a frodo shell using a connection profile (identified by the full AM base URL):  $ frodo shell https://openam-matrix.id.forgerock.io/am - Launch a frodo shell using a connection profile (identified by a unique substring of the AM base URL): + Launch a frodo shell using a connection profile (identified by a unique substring of the AM base URL or a saved alias):  $ frodo shell matrix  " diff --git a/test/client_cli/en/__snapshots__/theme-delete.test.js.snap b/test/client_cli/en/__snapshots__/theme-delete.test.js.snap index 620217b5b..b6881980b 100644 --- a/test/client_cli/en/__snapshots__/theme-delete.test.js.snap +++ b/test/client_cli/en/__snapshots__/theme-delete.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/theme-export.test.js.snap b/test/client_cli/en/__snapshots__/theme-export.test.js.snap index cf3edc234..eb0073d6d 100644 --- a/test/client_cli/en/__snapshots__/theme-export.test.js.snap +++ b/test/client_cli/en/__snapshots__/theme-export.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/theme-import.test.js.snap b/test/client_cli/en/__snapshots__/theme-import.test.js.snap index 4aa6ee3de..c079aac82 100644 --- a/test/client_cli/en/__snapshots__/theme-import.test.js.snap +++ b/test/client_cli/en/__snapshots__/theme-import.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/__snapshots__/theme-list.test.js.snap b/test/client_cli/en/__snapshots__/theme-list.test.js.snap index 77796bfe3..3b92d8a29 100644 --- a/test/client_cli/en/__snapshots__/theme-list.test.js.snap +++ b/test/client_cli/en/__snapshots__/theme-list.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/client_cli/en/conn-alias-add.test.js b/test/client_cli/en/conn-alias-add.test.js new file mode 100644 index 000000000..01f872490 --- /dev/null +++ b/test/client_cli/en/conn-alias-add.test.js @@ -0,0 +1,10 @@ +import cp from 'child_process'; +import { promisify } from 'util'; + +const exec = promisify(cp.exec); + +test("CLI help interface for 'conn alias' should be expected english", async () => { + const CMD = 'frodo conn alias add --help'; + const { stdout } = await exec(CMD); + expect(stdout).toMatchSnapshot(); +}); diff --git a/test/client_cli/en/conn-alias-delete.test.js b/test/client_cli/en/conn-alias-delete.test.js new file mode 100644 index 000000000..313d55345 --- /dev/null +++ b/test/client_cli/en/conn-alias-delete.test.js @@ -0,0 +1,10 @@ +import cp from 'child_process'; +import { promisify } from 'util'; + +const exec = promisify(cp.exec); + +test("CLI help interface for 'conn alias' should be expected english", async () => { + const CMD = 'frodo conn alias delete --help'; + const { stdout } = await exec(CMD); + expect(stdout).toMatchSnapshot(); +}); diff --git a/test/client_cli/en/conn-alias.test.js b/test/client_cli/en/conn-alias.test.js new file mode 100644 index 000000000..4f23771dd --- /dev/null +++ b/test/client_cli/en/conn-alias.test.js @@ -0,0 +1,10 @@ +import cp from 'child_process'; +import { promisify } from 'util'; + +const exec = promisify(cp.exec); + +test("CLI help interface for 'conn alias' should be expected english", async () => { + const CMD = 'frodo conn alias --help'; + const { stdout } = await exec(CMD); + expect(stdout).toMatchSnapshot(); +}); diff --git a/test/e2e/__snapshots__/conn-alias-add.e2e.test.js.snap b/test/e2e/__snapshots__/conn-alias-add.e2e.test.js.snap new file mode 100644 index 000000000..aed67b5f3 --- /dev/null +++ b/test/e2e/__snapshots__/conn-alias-add.e2e.test.js.snap @@ -0,0 +1,15 @@ +// Jest Snapshot v1, https://goo.gl/fbAQLP + +exports[`frodo conn alias add "frodo conn alias add testname https://openam-frodo-dev.forgeblocks.com/am": should add an alias 'testname' to the connection profile 1`] = `""`; + +exports[`frodo conn alias add "frodo conn alias add testname https://openam-frodo-dev.forgeblocks.com/am": should add an alias 'testname' to the connection profile 2`] = ` +"Alias 'testname' has been set for connection profile 'https://openam-frodo-dev.forgeblocks.com/am' +" +`; + +exports[`frodo conn alias add "frodo conn alias add testname https://openam-frodo-dev.forgeblocks.com/am": should fail to add alias and warn user the alias is already in use 1`] = ` +"Alias 'testname' is already in use by connection profile 'example.com'. Please use a unique alias. +" +`; + +exports[`frodo conn alias add "frodo conn alias add testname https://openam-frodo-dev.forgeblocks.com/am": should fail to add alias and warn user the alias is already in use 2`] = `""`; diff --git a/test/e2e/__snapshots__/conn-alias-delete.e2e.test.js.snap b/test/e2e/__snapshots__/conn-alias-delete.e2e.test.js.snap new file mode 100644 index 000000000..a07098a1e --- /dev/null +++ b/test/e2e/__snapshots__/conn-alias-delete.e2e.test.js.snap @@ -0,0 +1,15 @@ +// Jest Snapshot v1, https://goo.gl/fbAQLP + +exports[`frodo conn alias delete "frodo conn alias delete https://openam-frodo-dev.forgeblocks.com/am": should delete the alias of the connection profile 1`] = `""`; + +exports[`frodo conn alias delete "frodo conn alias delete https://openam-frodo-dev.forgeblocks.com/am": should delete the alias of the connection profile 2`] = ` +"Alias 'testname' has been deleted for connection profile 'https://openam-frodo-dev.forgeblocks.com/am'. +" +`; + +exports[`frodo conn alias delete "frodo conn alias delete https://openam-frodo-dev.forgeblocks.com/am": should fail to delete the nonexistent alias of the connection profile 1`] = ` +"No alias is set for connection profile 'https://openam-frodo-dev.forgeblocks.com/am' +" +`; + +exports[`frodo conn alias delete "frodo conn alias delete https://openam-frodo-dev.forgeblocks.com/am": should fail to delete the nonexistent alias of the connection profile 2`] = `""`; diff --git a/test/e2e/__snapshots__/conn-list.e2e.test.js.snap b/test/e2e/__snapshots__/conn-list.e2e.test.js.snap index f737599f5..8bec6c42e 100644 --- a/test/e2e/__snapshots__/conn-list.e2e.test.js.snap +++ b/test/e2e/__snapshots__/conn-list.e2e.test.js.snap @@ -1,14 +1,14 @@ // Jest Snapshot v1, https://goo.gl/fbAQLP exports[`frodo conn list "frodo conn list --long": should list the connection hosts, service accounts, usernames, and log API keys. 1`] = ` -"Host │Service Account │Username │Log API Key -https://openam-frodo-dev.forgeblocks.com/am│Frodo-SA-1687293271764│volker.scheuber@forgerock.com│2e3e7162c6861fdc50a10b6353ada65a +"Host │Alias│Service Account │Username │Log API Key +https://openam-frodo-dev.forgeblocks.com/am│ │Frodo-SA-1687293271764│volker.scheuber@forgerock.com│2e3e7162c6861fdc50a10b6353ada65a " `; exports[`frodo conn list "frodo conn list -l": should list the connection hosts, service accounts, usernames, and log API keys. 1`] = ` -"Host │Service Account │Username │Log API Key -https://openam-frodo-dev.forgeblocks.com/am│Frodo-SA-1687293271764│volker.scheuber@forgerock.com│2e3e7162c6861fdc50a10b6353ada65a +"Host │Alias│Service Account │Username │Log API Key +https://openam-frodo-dev.forgeblocks.com/am│ │Frodo-SA-1687293271764│volker.scheuber@forgerock.com│2e3e7162c6861fdc50a10b6353ada65a " `; diff --git a/test/e2e/__snapshots__/esv-secret-create.e2e.test.js.snap b/test/e2e/__snapshots__/esv-secret-create.e2e.test.js.snap index b8d018bbd..f7e2f720d 100644 --- a/test/e2e/__snapshots__/esv-secret-create.e2e.test.js.snap +++ b/test/e2e/__snapshots__/esv-secret-create.e2e.test.js.snap @@ -23,7 +23,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. username Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees. diff --git a/test/e2e/__snapshots__/idp-delete.e2e.test.js.snap b/test/e2e/__snapshots__/idp-delete.e2e.test.js.snap index ceae3f37b..c909bf936 100644 --- a/test/e2e/__snapshots__/idp-delete.e2e.test.js.snap +++ b/test/e2e/__snapshots__/idp-delete.e2e.test.js.snap @@ -9,7 +9,7 @@ Arguments: host AM base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a - unique substring. + unique substring or alias. realm Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise. (default: "alpha" for diff --git a/test/e2e/conn-alias-add.e2e.test.js b/test/e2e/conn-alias-add.e2e.test.js new file mode 100644 index 000000000..ee94bb0a2 --- /dev/null +++ b/test/e2e/conn-alias-add.e2e.test.js @@ -0,0 +1,102 @@ +/** + * Follow this process to write e2e tests for the CLI project: + * + * 1. Test if all the necessary mocks for your tests already exist. + * In mock mode, run the command you want to test with the same arguments + * and parameters exactly as you want to test it, for example: + * + * $ FRODO_MOCK=1 frodo conn save https://openam-frodo-dev.forgeblocks.com/am volker.scheuber@forgerock.com Sup3rS3cr3t! + * + * If your command completes without errors and with the expected results, + * all the required mocks already exist and you are good to write your + * test and skip to step #4. + * + * If, however, your command fails and you see errors like the one below, + * you know you need to record the mock responses first: + * + * [Polly] [adapter:node-http] Recording for the following request is not found and `recordIfMissing` is `false`. + * + * 2. Record mock responses for your exact command. + * In mock record mode, run the command you want to test with the same arguments + * and parameters exactly as you want to test it, for example: + * + * $ FRODO_MOCK=record frodo conn save https://openam-frodo-dev.forgeblocks.com/am volker.scheuber@forgerock.com Sup3rS3cr3t! + * + * Wait until you see all the Polly instances (mock recording adapters) have + * shutdown before you try to run step #1 again. + * Messages like these indicate mock recording adapters shutting down: + * + * Polly instance 'conn/4' stopping in 3s... + * Polly instance 'conn/4' stopping in 2s... + * Polly instance 'conn/save/3' stopping in 3s... + * Polly instance 'conn/4' stopping in 1s... + * Polly instance 'conn/save/3' stopping in 2s... + * Polly instance 'conn/4' stopped. + * Polly instance 'conn/save/3' stopping in 1s... + * Polly instance 'conn/save/3' stopped. + * + * 3. Validate your freshly recorded mock responses are complete and working. + * Re-run the exact command you want to test in mock mode (see step #1). + * + * 4. Write your test. + * Make sure to use the exact command including number of arguments and params. + * + * 5. Commit both your test and your new recordings to the repository. + * Your tests are likely going to reside outside the frodo-lib project but + * the recordings must be committed to the frodo-lib project. + */ +import cp from 'child_process'; +import { promisify } from 'util'; +import { getEnv, removeAnsiEscapeCodes, testif } from './utils/TestUtils'; +import { connection as c } from './utils/TestConfig'; +import { readFileSync, rmSync, writeFileSync } from 'fs'; + +const exec = promisify(cp.exec); +const connectionsFile = './test/e2e/env/Connections.json'; +const connectionsAliasFile = './test/e2e/env/ConnectionsAlias.json'; + +process.env['FRODO_MOCK'] = '1'; +process.env['FRODO_CONNECTION_PROFILES_PATH'] = connectionsAliasFile; +const env = getEnv(); +const alias = 'testname'; + +beforeEach(() => { + writeFileSync(connectionsAliasFile, readFileSync(connectionsFile)); +}); + +afterAll(() => { + rmSync(connectionsAliasFile); +}); + +describe('frodo conn alias add', () => { + testif(process.env['FRODO_MASTER_KEY'])( + `"frodo conn alias add ${alias} ${c.host}": should add an alias 'testname' to the connection profile`, + async () => { + const CMD = `frodo conn alias add ${alias} ${c.host}`; + const { stdout, stderr } = await exec(CMD, env); + expect(removeAnsiEscapeCodes(stdout)).toMatchSnapshot(); + expect(removeAnsiEscapeCodes(stderr)).toMatchSnapshot(); + } + ); + testif(process.env['FRODO_MASTER_KEY'])( + `"frodo conn alias add ${alias} ${c.host}": should fail to add alias and warn user the alias is already in use`, + async () => { + const profiles = JSON.parse(readFileSync(connectionsAliasFile, 'utf-8')); + profiles['example.com'] = { + ...profiles[c.host], + host: 'example.com', + alias: alias, + }; + writeFileSync(connectionsAliasFile, JSON.stringify(profiles, null, 2)); + const CMD = `frodo conn alias add ${alias} ${c.host}`; + try { + await exec(CMD, env); + throw new Error('Expected command to fail'); + } catch (e) { + expect(removeAnsiEscapeCodes(e.stderr)).toMatchSnapshot(); + expect(removeAnsiEscapeCodes(e.stdout)).toMatchSnapshot(); + } + expect.assertions(2); + } + ); +}); diff --git a/test/e2e/conn-alias-delete.e2e.test.js b/test/e2e/conn-alias-delete.e2e.test.js new file mode 100644 index 000000000..07013c954 --- /dev/null +++ b/test/e2e/conn-alias-delete.e2e.test.js @@ -0,0 +1,107 @@ +/** + * Follow this process to write e2e tests for the CLI project: + * + * 1. Test if all the necessary mocks for your tests already exist. + * In mock mode, run the command you want to test with the same arguments + * and parameters exactly as you want to test it, for example: + * + * $ FRODO_MOCK=1 frodo conn save https://openam-frodo-dev.forgeblocks.com/am volker.scheuber@forgerock.com Sup3rS3cr3t! + * + * If your command completes without errors and with the expected results, + * all the required mocks already exist and you are good to write your + * test and skip to step #4. + * + * If, however, your command fails and you see errors like the one below, + * you know you need to record the mock responses first: + * + * [Polly] [adapter:node-http] Recording for the following request is not found and `recordIfMissing` is `false`. + * + * 2. Record mock responses for your exact command. + * In mock record mode, run the command you want to test with the same arguments + * and parameters exactly as you want to test it, for example: + * + * $ FRODO_MOCK=record frodo conn save https://openam-frodo-dev.forgeblocks.com/am volker.scheuber@forgerock.com Sup3rS3cr3t! + * + * Wait until you see all the Polly instances (mock recording adapters) have + * shutdown before you try to run step #1 again. + * Messages like these indicate mock recording adapters shutting down: + * + * Polly instance 'conn/4' stopping in 3s... + * Polly instance 'conn/4' stopping in 2s... + * Polly instance 'conn/save/3' stopping in 3s... + * Polly instance 'conn/4' stopping in 1s... + * Polly instance 'conn/save/3' stopping in 2s... + * Polly instance 'conn/4' stopped. + * Polly instance 'conn/save/3' stopping in 1s... + * Polly instance 'conn/save/3' stopped. + * + * 3. Validate your freshly recorded mock responses are complete and working. + * Re-run the exact command you want to test in mock mode (see step #1). + * + * 4. Write your test. + * Make sure to use the exact command including number of arguments and params. + * + * 5. Commit both your test and your new recordings to the repository. + * Your tests are likely going to reside outside the frodo-lib project but + * the recordings must be committed to the frodo-lib project. + */ +import cp from 'child_process'; +import { promisify } from 'util'; +import { getEnv, removeAnsiEscapeCodes, testif } from './utils/TestUtils'; +import { connection as c } from './utils/TestConfig'; +import { readFileSync, rmSync, writeFileSync } from 'fs'; + +const exec = promisify(cp.exec); +const connectionsFile = './test/e2e/env/Connections.json'; +const connectionsAliasFile = './test/e2e/env/ConnectionsAlias.json'; + +process.env['FRODO_MOCK'] = '1'; +process.env['FRODO_CONNECTION_PROFILES_PATH'] = connectionsAliasFile; +const env = getEnv(); + +beforeAll(() => { + const originalProfiles = JSON.parse(readFileSync(connectionsFile, 'utf8')); + const aliasProfiles = { + ...originalProfiles, + [c.host]: { + ...originalProfiles[c.host], + alias: 'testname', + }, + }; + writeFileSync(connectionsAliasFile, JSON.stringify(aliasProfiles, null, 2)); +}); + +afterAll(() => { + rmSync(connectionsAliasFile); +}); + +describe('frodo conn alias delete', () => { + testif(process.env['FRODO_MASTER_KEY'])( + `"frodo conn alias delete ${c.host}": should delete the alias of the connection profile`, + async () => { + const CMD = `frodo conn alias delete ${c.host}`; + const { stdout, stderr } = await exec(CMD, env); + expect(removeAnsiEscapeCodes(stdout)).toMatchSnapshot(); + expect(removeAnsiEscapeCodes(stderr)).toMatchSnapshot(); + } + ); + testif(process.env['FRODO_MASTER_KEY'])( + `"frodo conn alias delete ${c.host}": should fail to delete the nonexistent alias of the connection profile`, + async () => { + const profiles = JSON.parse(readFileSync(connectionsAliasFile, 'utf-8')); + profiles[c.host] = { + ...profiles[c.host], + alias: '', + }; + const CMD = `frodo conn alias delete ${c.host}`; + try { + await exec(CMD, env); + throw new Error('Expected command to fail'); + } catch (e) { + expect(removeAnsiEscapeCodes(e.stderr)).toMatchSnapshot(); + expect(removeAnsiEscapeCodes(e.stdout)).toMatchSnapshot(); + } + expect.assertions(2); + } + ); +});