opal-security 3.1.1-beta.7cc0a74 → 3.1.1-beta.7e1cc21

package/README.md

@@ -22,7 +22,7 @@ $ npm install -g opal-security
 $ opal COMMAND
 running command...
 $ opal (--version)
-opal-security/3.1.1-beta.7cc0a74 linux-x64 node-v20.19.2
+opal-security/3.1.1-beta.7e1cc21 linux-x64 node-v20.19.2
 $ opal --help [COMMAND]
 USAGE
   $ opal COMMAND
@@ -44,6 +44,9 @@ USAGE
 * [`opal login`](#opal-login)
 * [`opal logout`](#opal-logout)
 * [`opal postgres-instances start`](#opal-postgres-instances-start)
+* [`opal request create`](#opal-request-create)
+* [`opal request get`](#opal-request-get)
+* [`opal request list`](#opal-request-list)
 * [`opal resources get`](#opal-resources-get)
 * [`opal set-auth-provider`](#opal-set-auth-provider)
 * [`opal set-custom-header`](#opal-set-custom-header)
@@ -53,6 +56,7 @@ USAGE
 * [`opal ssh copyTo`](#opal-ssh-copyto)
 * [`opal ssh start`](#opal-ssh-start)
 * [`opal version`](#opal-version)
+* [`opal whoami`](#opal-whoami)
 
 ## `opal autocomplete [SHELL]`
 
@@ -101,7 +105,7 @@ EXAMPLES
   $ opal aws:identity
 ```
 
-_See code: [src/commands/aws/identity.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7cc0a74/src/commands/aws/identity.ts)_
+_See code: [src/commands/aws/identity.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7e1cc21/src/commands/aws/identity.ts)_
 
 ## `opal clear-auth-provider`
 
@@ -121,7 +125,7 @@ EXAMPLES
   $ opal clear-auth-provider
 ```
 
-_See code: [src/commands/clear-auth-provider.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7cc0a74/src/commands/clear-auth-provider.ts)_
+_See code: [src/commands/clear-auth-provider.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7e1cc21/src/commands/clear-auth-provider.ts)_
 
 ## `opal curl-example`
 
@@ -138,7 +142,7 @@ DESCRIPTION
   Prints out an example cURL command containing the parameters the CLI uses to query the Opal server.
 ```
 
-_See code: [src/commands/curl-example.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7cc0a74/src/commands/curl-example.ts)_
+_See code: [src/commands/curl-example.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7e1cc21/src/commands/curl-example.ts)_
 
 ## `opal groups get`
 
@@ -159,7 +163,7 @@ EXAMPLES
   $ opal groups:get --id 54052a3e-5375-4392-aeaf-0c6c44c131d4
 ```
 
-_See code: [src/commands/groups/get.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7cc0a74/src/commands/groups/get.ts)_
+_See code: [src/commands/groups/get.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7e1cc21/src/commands/groups/get.ts)_
 
 ## `opal help [COMMANDS]`
 
@@ -209,7 +213,7 @@ EXAMPLES
   $ opal iam-roles:start --id 51f7176b-0464-4a6f-8369-e951e187b398 --profileName "custom-profile"
 ```
 
-_See code: [src/commands/iam-roles/start.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7cc0a74/src/commands/iam-roles/start.ts)_
+_See code: [src/commands/iam-roles/start.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7e1cc21/src/commands/iam-roles/start.ts)_
 
 ## `opal kube-roles start`
 
@@ -240,7 +244,7 @@ EXAMPLES
   $ opal kube-roles:start --id 51f7176b-0464-4a6f-8369-e951e187b398 --accessLevelRemoteId "arn:aws:iam::712234975475:role/acme-eks-cluster-admin-role"
 ```
 
-_See code: [src/commands/kube-roles/start.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7cc0a74/src/commands/kube-roles/start.ts)_
+_See code: [src/commands/kube-roles/start.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7e1cc21/src/commands/kube-roles/start.ts)_
 
 ## `opal login`
 
@@ -261,7 +265,7 @@ EXAMPLES
   $ opal login
 ```
 
-_See code: [src/commands/login.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7cc0a74/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7e1cc21/src/commands/login.ts)_
 
 ## `opal logout`
 
@@ -281,7 +285,7 @@ EXAMPLES
   $ opal logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7cc0a74/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7e1cc21/src/commands/logout.ts)_
 
 ## `opal postgres-instances start`
 
@@ -318,7 +322,82 @@ EXAMPLES
   $ opal postgres-instances:start --id 51f7176b-0464-4a6f-8369-e951e187b398 --accessLevelRemoteId fullaccess --action view
 ```
 
-_See code: [src/commands/postgres-instances/start.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7cc0a74/src/commands/postgres-instances/start.ts)_
+_See code: [src/commands/postgres-instances/start.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7e1cc21/src/commands/postgres-instances/start.ts)_
+
+## `opal request create`
+
+Creates an Opal access request via an interactive form
+
+```
+USAGE
+  $ opal request create [-h] [-a <value>...] [-r <value>] [-d <value>]
+
+FLAGS
+  -a, --assets=<value>...  The ids of the assets (resource, group) to request access to. Append a role ID using a colon
+                           if needed, e.g. `--assets 123:456`.
+                           If not provided, an interactive selection flow will be available to select assets to request.
+  -d, --duration=<value>   The duration of access for the request in minutes. If not provided, you will be prompted.
+  -h, --help               Show CLI help.
+  -r, --reason=<value>     The reason for the request, contained in quotes. If not provided, you will be prompted.
+
+DESCRIPTION
+  Creates an Opal access request via an interactive form
+```
+
+_See code: [src/commands/request/create.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7e1cc21/src/commands/request/create.ts)_
+
+## `opal request get`
+
+Lists access requests
+
+```
+USAGE
+  $ opal request get [-h] [-i <value>] [-v]
+
+FLAGS
+  -h, --help        Show CLI help.
+  -i, --id=<value>  The Opal ID of the asset. You can find this from the URL, e.g. https://opal.dev/resources/[ID]
+  -v, --verbose     Enable verbose output, prints full response in JSON format. Defaults to false.
+
+DESCRIPTION
+  Lists access requests
+
+EXAMPLES
+  $ opal request get --id 54052a3e-5375-4392-aeaf-0c6c44c131d4
+
+  $ opal request get --id 54052a3e-5375-4392-aeaf-0c6c44c131d4 --verbose
+```
+
+_See code: [src/commands/request/get.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7e1cc21/src/commands/request/get.ts)_
+
+## `opal request list`
+
+Lists your n recent outgoing access requests
+
+```
+USAGE
+  $ opal request list [-h] [-n <value>] [-p] [-v]
+
+FLAGS
+  -h, --help       Show CLI help.
+  -n, --n=<value>  [default: 10] Defines number of requests to be returned. 1 <= n <= 100.
+  -p, --pending    Show only pending requests. Defaults to false.
+  -v, --verbose    Enable verbose output, prints full response in JSON format. Defaults to false.
+
+DESCRIPTION
+  Lists your n recent outgoing access requests
+
+EXAMPLES
+  $ opal request list --n 5
+
+  $ opal request list --n 5 --pending
+
+  $ opal request list --n 5 --verbose
+
+  $ opal request list --n 5 --pending --verbose
+```
+
+_See code: [src/commands/request/list.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7e1cc21/src/commands/request/list.ts)_
 
 ## `opal resources get`
 
@@ -339,7 +418,7 @@ EXAMPLES
   $ opal resources:get --id 54052a3e-5375-4392-aeaf-0c6c44c131d4
 ```
 
-_See code: [src/commands/resources/get.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7cc0a74/src/commands/resources/get.ts)_
+_See code: [src/commands/resources/get.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7e1cc21/src/commands/resources/get.ts)_
 
 ## `opal set-auth-provider`
 
@@ -365,7 +444,7 @@ EXAMPLES
   $ opal set-auth-provider --clientID 1234asdf --issuerUrl https://auth.example.com
 ```
 
-_See code: [src/commands/set-auth-provider.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7cc0a74/src/commands/set-auth-provider.ts)_
+_See code: [src/commands/set-auth-provider.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7e1cc21/src/commands/set-auth-provider.ts)_
 
 ## `opal set-custom-header`
 
@@ -386,7 +465,7 @@ EXAMPLES
   $ opal set-custom-header --header 'cf-access-token: $TOKEN'
 ```
 
-_See code: [src/commands/set-custom-header.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7cc0a74/src/commands/set-custom-header.ts)_
+_See code: [src/commands/set-custom-header.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7e1cc21/src/commands/set-custom-header.ts)_
 
 ## `opal set-token`
 
@@ -406,7 +485,7 @@ EXAMPLES
   $ opal set-token
 ```
 
-_See code: [src/commands/set-token.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7cc0a74/src/commands/set-token.ts)_
+_See code: [src/commands/set-token.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7e1cc21/src/commands/set-token.ts)_
 
 ## `opal set-url [URL]`
 
@@ -430,7 +509,7 @@ EXAMPLES
   $ opal set-url
 ```
 
-_See code: [src/commands/set-url.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7cc0a74/src/commands/set-url.ts)_
+_See code: [src/commands/set-url.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7e1cc21/src/commands/set-url.ts)_
 
 ## `opal ssh copyFrom`
 
@@ -461,7 +540,7 @@ EXAMPLES
   $ opal ssh:copyFrom --src instance/dir --dest my/dir --id 51f7176b-0464-4a6f-8369-e951e187b398
 ```
 
-_See code: [src/commands/ssh/copyFrom.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7cc0a74/src/commands/ssh/copyFrom.ts)_
+_See code: [src/commands/ssh/copyFrom.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7e1cc21/src/commands/ssh/copyFrom.ts)_
 
 ## `opal ssh copyTo`
 
@@ -492,7 +571,7 @@ EXAMPLES
   $ opal ssh:copyTo --src my/dir --dest instance/dir --id 51f7176b-0464-4a6f-8369-e951e187b398
 ```
 
-_See code: [src/commands/ssh/copyTo.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7cc0a74/src/commands/ssh/copyTo.ts)_
+_See code: [src/commands/ssh/copyTo.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7e1cc21/src/commands/ssh/copyTo.ts)_
 
 ## `opal ssh start`
 
@@ -519,7 +598,7 @@ EXAMPLES
   $ opal ssh:start --id 51f7176b-0464-4a6f-8369-e951e187b398
 ```
 
-_See code: [src/commands/ssh/start.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7cc0a74/src/commands/ssh/start.ts)_
+_See code: [src/commands/ssh/start.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7e1cc21/src/commands/ssh/start.ts)_
 
 ## `opal version`
 
@@ -540,4 +619,21 @@ FLAG DESCRIPTIONS
 ```
 
 _See code: [@oclif/plugin-version](https://github.com/oclif/plugin-version/blob/v2.2.27/src/commands/version.ts)_
+
+## `opal whoami`
+
+Describes current url set, organization name, and logged in user if applicabled.
+
+```
+USAGE
+  $ opal whoami [-h]
+
+FLAGS
+  -h, --help  Show CLI help.
+
+DESCRIPTION
+  Describes current url set, organization name, and logged in user if applicabled.
+```
+
+_See code: [src/commands/whoami.ts](https://github.com/opalsecurity/opal-cli/blob/v3.1.1-beta.7e1cc21/src/commands/whoami.ts)_
 <!-- commandsstop -->

package/lib/commands/login.js

@@ -88,12 +88,14 @@ class Login extends core_1.Command {
             const configData = (0, config_1.getOrCreateConfigData)(configDir);
             let email = flags.email;
             let organizationId;
+            let organizationName;
             let clientIDCandidate;
             const existingCreds = await (0, credentials_1.getOpalCredentials)(this, false);
             // Only use the previous email + organizationID if email isn't explicitly specified.
             if (!email) {
                 email = existingCreds.email;
                 organizationId = existingCreds.organizationID;
+                organizationName = existingCreds.organizationName;
                 clientIDCandidate = existingCreds.clientIDCandidate;
             }
             await (0, credentials_1.removeOpalCredentials)(this);
@@ -149,6 +151,7 @@ class Login extends core_1.Command {
                 if (signInOrganizations && signInOrganizations.length > 0) {
                     if (signInOrganizations.length === 1) {
                         organizationId = signInOrganizations[0].organizationId;
+                        organizationName = signInOrganizations[0].organizationName;
                         clientIDCandidate = signInOrganizations[0].cliClientId;
                     }
                     else {
@@ -164,6 +167,7 @@ class Login extends core_1.Command {
                             },
                         ]);
                         organizationId = responses.signInOrganization.organizationId;
+                        organizationName = responses.signInOrganization.organizationName;
                         clientIDCandidate = responses.signInOrganization.cliClientId;
                     }
                 }
@@ -238,10 +242,10 @@ class Login extends core_1.Command {
             if (tokenExchangeError) {
                 this.log("WARN: Failed to exchange access token for session in Opal. Falling back to using access token for authenticating requests\n");
                 // TODO: consider adding a warn line recommending upgrading Opal to version XYZ, once accompanying PR is pushed to prod
-                await (0, credentials_1.setOpalCredentials)(this, email, organizationId !== null && organizationId !== void 0 ? organizationId : "", clientIDCandidate, (tokenSet === null || tokenSet === void 0 ? void 0 : tokenSet.access_token) || "", credentials_1.SecretType.ApiToken);
+                await (0, credentials_1.setOpalCredentials)(this, email, organizationId !== null && organizationId !== void 0 ? organizationId : "", clientIDCandidate, (tokenSet === null || tokenSet === void 0 ? void 0 : tokenSet.access_token) || "", credentials_1.SecretType.ApiToken, organizationName);
             }
             else {
-                await (0, credentials_1.setOpalCredentials)(this, email, organizationId !== null && organizationId !== void 0 ? organizationId : "", clientIDCandidate, apollo_1.cookieStr, credentials_1.SecretType.Cookie);
+                await (0, credentials_1.setOpalCredentials)(this, email, organizationId !== null && organizationId !== void 0 ? organizationId : "", clientIDCandidate, apollo_1.cookieStr, credentials_1.SecretType.Cookie, organizationName);
             }
             // "Representative" authenticated call to check the log-in worked as expected.
             const { resp: authCheckResp, error: authCheckErr } = await (0, handler_1.runQueryDeprecated)({

package/lib/commands/request/create.d.ts

@@ -1,10 +1,9 @@
 import { Command } from "@oclif/core";
 export default class RequestCreate extends Command {
-    static hidden: boolean;
     static description: string;
     static flags: {
         help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
-        id: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        assets: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         reason: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         duration: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };

package/lib/commands/request/create.js

@@ -2,20 +2,20 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const apollo_1 = require("../../lib/apollo");
+const cmd_1 = require("../../lib/cmd");
 const flags_1 = require("../../lib/flags");
 const requests_1 = require("../../lib/requests");
 const displays_1 = require("../../utils/displays");
-const utils_1 = require("../../utils/utils");
 class RequestCreate extends core_1.Command {
     async run() {
+        (0, cmd_1.setMostRecentCommand)(this);
         await (0, apollo_1.initClient)(this, true);
         const client = await (0, apollo_1.getClient)(this, true);
-        (0, utils_1.restrictToDev)(); //TODO: Remove after development is complete
         const { flags } = await this.parse(RequestCreate);
         const metadata = (0, requests_1.initEmptyRequestMetadata)();
-        if (flags.id) {
+        if (flags.assets) {
             // if IDs are provided, bypass the interactive selection process
-            (0, requests_1.bypassRequestSelection)(this, client, flags.id, metadata);
+            await (0, requests_1.bypassRequestSelection)(this, client, flags.assets, metadata);
         }
         else {
             (0, displays_1.headerMessage)(this);
@@ -36,7 +36,9 @@ class RequestCreate extends core_1.Command {
         if (flags.reason) {
             metadata.reason = flags.reason;
         }
-        else {
+        else if (!(metadata.requestDefaults.reasonOptional &&
+            flags.assets &&
+            flags.duration)) {
             await (0, requests_1.promptForReason)(metadata);
         }
         // Step 5: Prompt for expiration
@@ -47,21 +49,24 @@ class RequestCreate extends core_1.Command {
             await (0, requests_1.promptForExpiration)(metadata);
         }
         // Step 6: Display final summary of request
-        if (!(flags.id && flags.reason && flags.duration)) {
-            await (0, requests_1.promptRequestSubmition)(this, metadata);
+        let canSubmit = true;
+        if (!(flags.assets &&
+            flags.duration &&
+            (metadata.requestDefaults.reasonOptional || flags.reason))) {
+            canSubmit = await (0, requests_1.promptRequestSubmission)(this, metadata);
         }
-        // Step 7: Prompt for final submition
-        await (0, requests_1.submitFinalRequest)(this, client, metadata);
+        // Step 7: Prompt for final submission
+        if (canSubmit)
+            await (0, requests_1.submitFinalRequest)(this, client, metadata);
     }
 }
-RequestCreate.hidden = true;
 RequestCreate.description = "Creates an Opal access request via an interactive form";
 RequestCreate.flags = {
     help: flags_1.SHARED_FLAGS.help,
-    id: core_1.Flags.string({
-        char: "i",
+    assets: core_1.Flags.string({
+        char: "a",
         multiple: true,
-        description: "The id of the asset (resource, group) to request access to. Append a role ID using a colon if needed, e.g. `--id 123:456`.\
+        description: "The ids of the assets (resource, group) to request access to. Append a role ID using a colon if needed, e.g. `--assets 123:456`.\
         \n If not provided, an interactive selection flow will be available to select assets to request.",
     }),
     reason: core_1.Flags.string({

package/lib/commands/request/get.d.ts

@@ -1,6 +1,5 @@
 import { Command } from "@oclif/core";
 export default class GetRequest extends Command {
-    static hidden: boolean;
     static description: string;
     static flags: {
         help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;

package/lib/commands/request/get.js

@@ -8,7 +8,6 @@ const cmd_1 = require("../../lib/cmd");
 const config_1 = require("../../lib/config");
 const flags_1 = require("../../lib/flags");
 const displays_1 = require("../../utils/displays");
-const utils_1 = require("../../utils/utils");
 const GET_REQUEST = (0, graphql_1.graphql)(`
   query GetRequest(
   $id: RequestId!
@@ -58,14 +57,13 @@ const GET_REQUEST = (0, graphql_1.graphql)(`
 `);
 class GetRequest extends core_1.Command {
     async run() {
-        (0, utils_1.restrictToDev)(); //TODO: Remove after development is complete
         (0, cmd_1.setMostRecentCommand)(this);
         const configData = (0, config_1.getOrCreateConfigData)(this.config.configDir);
         const client = await (0, apollo_1.getClient)(this, true);
         // Verify id tag was provided
         const { flags } = await this.parse(GetRequest);
         if (!flags.id) {
-            this.log("Error: Please provide a group ID using the --id flag.");
+            this.log("Error: Please provide a request ID using the --id flag.");
             this.log("ex. opal request get --id 54052a3e-5375-4392-aeaf-0c6c44c131d4");
             return;
         }
@@ -96,7 +94,6 @@ class GetRequest extends core_1.Command {
         }
     }
 }
-GetRequest.hidden = true;
 GetRequest.description = "Lists access requests";
 GetRequest.flags = {
     help: flags_1.SHARED_FLAGS.help,

package/lib/commands/request/list.d.ts

@@ -1,6 +1,5 @@
 import { Command } from "@oclif/core";
 export default class ListRequests extends Command {
-    static hidden: boolean;
     static description: string;
     static examples: string[];
     static flags: {

package/lib/commands/request/list.js

@@ -6,7 +6,6 @@ const apollo_1 = require("../../lib/apollo");
 const cmd_1 = require("../../lib/cmd");
 const flags_1 = require("../../lib/flags");
 const displays_1 = require("../../utils/displays");
-const utils_1 = require("../../utils/utils");
 // Add date filters, search query,
 const GET_REQUESTS = (0, graphql_1.graphql)(`
   query GetRequests($pageSize: Int, $showPendingOnly: Boolean!) {
@@ -59,7 +58,6 @@ const GET_REQUESTS = (0, graphql_1.graphql)(`
 }`);
 class ListRequests extends core_1.Command {
     async run() {
-        (0, utils_1.restrictToDev)(); //TODO: Remove after development is complete
         (0, cmd_1.setMostRecentCommand)(this);
         const client = await (0, apollo_1.getClient)(this, true);
         let pageSize = 10;
@@ -88,7 +86,6 @@ class ListRequests extends core_1.Command {
         }
     }
 }
-ListRequests.hidden = true;
 ListRequests.description = "Lists your n recent outgoing access requests";
 ListRequests.examples = [
     "opal request list --n 5",

package/lib/commands/whoami.d.ts

@@ -0,0 +1,8 @@
+import { Command } from "@oclif/core";
+export default class WhoAmI extends Command {
+    static description: string;
+    static flags: {
+        help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
+    };
+    run(): Promise<void>;
+}

package/lib/commands/whoami.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const config_1 = require("../lib/config");
+const credentials_1 = require("../lib/credentials");
+const flags_1 = require("../lib/flags");
+class WhoAmI extends core_1.Command {
+    async run() {
+        const opalCreds = await (0, credentials_1.getOpalCredentials)(this, false);
+        const organizationName = opalCreds === null || opalCreds === void 0 ? void 0 : opalCreds.organizationName;
+        const email = opalCreds === null || opalCreds === void 0 ? void 0 : opalCreds.email;
+        const configData = (0, config_1.getOrCreateConfigData)(this.config.configDir);
+        const url = configData[config_1.urlKey];
+        if (email) {
+            this.log(`User:         ${email}`);
+        }
+        if (organizationName) {
+            if (organizationName === "unset-org-id") {
+                this.log("Authenticated with Opal API Token.");
+            }
+            else {
+                this.log(`Organization: ${organizationName}`);
+            }
+        }
+        if (url) {
+            this.log(`Server:       ${url}`);
+        }
+    }
+}
+WhoAmI.description = "Describes current url set, organization name, and logged in user if applicabled.";
+WhoAmI.flags = {
+    help: flags_1.SHARED_FLAGS.help,
+};
+exports.default = WhoAmI;

package/lib/lib/apollo.js

@@ -155,7 +155,7 @@ const initClient = async (command, fetchAccessToken = true) => {
             return response;
         });
     });
-    const errorLink = (0, error_1.onError)(({ networkError, operation }) => {
+    const errorLink = (0, error_1.onError)(({ networkError, operation, forward }) => {
         var _a;
         // There's a few GQL operations where we don't want to use this error handler:
         const customErrorOperations = [
@@ -186,7 +186,7 @@ const initClient = async (command, fetchAccessToken = true) => {
                 case 401: {
                     command.log("Your session is invalid or expired. Authenticating now...\n");
                     const loginCommand = new login_1.default([], command.config);
-                    loginCommand.run().then(() => {
+                    return (0, core_1.fromPromise)(loginCommand.run().then(() => {
                         if (cmd_1.mostRecentCommandTime && cmd_1.mostRecentCommand) {
                             const lastCommandReexecutionDuration = moment.duration(2, "minutes");
                             const lastCommandReexecutionDurationHasElapsed = cmd_1.mostRecentCommandTime.add(lastCommandReexecutionDuration) >
@@ -195,8 +195,7 @@ const initClient = async (command, fetchAccessToken = true) => {
                                 cmd_1.mostRecentCommand.run();
                             }
                         }
-                    });
-                    break;
+                    })).flatMap(() => forward(operation));
                 }
                 default:
                     return (0, exports.handleError)(command, `Received status code ${networkError.statusCode} from server${errorMessage ? ` with message "${errorMessage}"` : ""}`);

package/lib/lib/credentials/index.d.ts

@@ -5,12 +5,13 @@ interface OpalCredentials {
     clientIDCandidate?: string;
     secret?: string;
     secretType?: SecretType;
+    organizationName?: string;
 }
 export declare enum SecretType {
     Cookie = "COOKIE",
     ApiToken = "API_TOKEN"
 }
-export declare const setOpalCredentials: (command: Command, email: string | undefined, organizationID: string, clientIDCandidate: string | undefined | null, secret: string, secretType: SecretType) => Promise<void>;
+export declare const setOpalCredentials: (command: Command, email: string | undefined, organizationID: string, clientIDCandidate: string | undefined | null, secret: string, secretType: SecretType, organizationName?: string) => Promise<void>;
 export declare const getOpalCredentials: (command: Command, includeAuthSecret?: boolean) => Promise<OpalCredentials>;
 export declare const removeOpalCredentials: (command: Command) => Promise<void>;
 export {};

package/lib/lib/credentials/index.js

@@ -9,13 +9,14 @@ var SecretType;
     SecretType["Cookie"] = "COOKIE";
     SecretType["ApiToken"] = "API_TOKEN";
 })(SecretType || (exports.SecretType = SecretType = {}));
-const setOpalCredentials = async (command, email, organizationID, clientIDCandidate, secret, secretType) => {
+const setOpalCredentials = async (command, email, organizationID, clientIDCandidate, secret, secretType, organizationName) => {
     const givenEmail = email || "email-unset";
     const configData = (0, config_1.getOrCreateConfigData)(command.config.configDir);
     configData.creds = {
         clientIDCandidate,
         email,
         organizationID,
+        organizationName,
         secretType,
     };
     (0, config_1.writeConfigData)(command.config.configDir, configData);

package/lib/lib/requests.d.ts

@@ -1,16 +1,17 @@
 import type { NormalizedCacheObject } from "@apollo/client/core";
 import type { ApolloClient } from "@apollo/client/core/ApolloClient";
 import type { Command } from "@oclif/core/lib/command";
+import { type AppType, type ConnectionType, EntityType } from "../graphql/graphql";
 type AppNode = {
     appId: string;
     appName: string;
-    appType?: string;
+    appType?: AppType | ConnectionType;
     assets: Record<string, AssetNode>;
 };
 type AssetNode = {
     assetId: string;
     assetName: string;
-    type: string;
+    type: EntityType;
     roles?: Record<string, RoleNode>;
 };
 type RoleNode = {
@@ -18,6 +19,7 @@ type RoleNode = {
     roleName: string;
 };
 export type RequestMap = Record<string, AppNode>;
+export declare const DISPLAY_LABELS: Partial<Record<EntityType, string>>;
 type DurationOption = {
     durationInMinutes: number;
     label: string;
@@ -44,7 +46,7 @@ export declare function doneSelectingAssets(): Promise<boolean>;
 export declare function setRequestDefaults(cmd: Command, client: ApolloClient<NormalizedCacheObject>, metadata: RequestMetadata): Promise<void>;
 export declare function promptForReason(metadata: RequestMetadata): Promise<void>;
 export declare function promptForExpiration(metadata: RequestMetadata): Promise<void>;
-export declare function promptRequestSubmition(cmd: Command, metadata: RequestMetadata): Promise<void>;
+export declare function promptRequestSubmission(cmd: Command, metadata: RequestMetadata): Promise<boolean>;
 export declare function submitFinalRequest(cmd: Command, client: ApolloClient<NormalizedCacheObject>, metadata: RequestMetadata): Promise<void>;
 export declare function bypassRequestSelection(cmd: Command, client: ApolloClient<NormalizedCacheObject>, flagValue: string[], metadata: RequestMetadata): Promise<void>;
 export declare function bypassDuration(cmd: Command, duration: number, metadata: RequestMetadata): void;

package/lib/lib/requests.js

@@ -1,22 +1,37 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.DISPLAY_LABELS = void 0;
 exports.initEmptyRequestMetadata = initEmptyRequestMetadata;
 exports.selectRequestableItems = selectRequestableItems;
 exports.doneSelectingAssets = doneSelectingAssets;
 exports.setRequestDefaults = setRequestDefaults;
 exports.promptForReason = promptForReason;
 exports.promptForExpiration = promptForExpiration;
-exports.promptRequestSubmition = promptRequestSubmition;
+exports.promptRequestSubmission = promptRequestSubmission;
 exports.submitFinalRequest = submitFinalRequest;
 exports.bypassRequestSelection = bypassRequestSelection;
 exports.bypassDuration = bypassDuration;
 const chalk_1 = require("chalk");
-const inquirer = require("inquirer");
 const graphql_1 = require("../graphql");
 const graphql_2 = require("../graphql/graphql");
 const displays_1 = require("../utils/displays");
 const config_1 = require("./config");
 const { AutoComplete, Select, prompt, Form } = require("enquirer");
+function entityTypeFromString(str) {
+    const capStr = str === null || str === void 0 ? void 0 : str.toLocaleUpperCase();
+    if (capStr === "RESOURCE") {
+        return graphql_2.EntityType.Resource;
+    }
+    if (capStr === "GROUP") {
+        return graphql_2.EntityType.Group;
+    }
+    // if type unknown, default to resource
+    return graphql_2.EntityType.Resource;
+}
+exports.DISPLAY_LABELS = {
+    [graphql_2.EntityType.Resource]: "Resource",
+    [graphql_2.EntityType.Group]: "Group",
+};
 function initEmptyRequestMetadata() {
     // Initialize with empty defaults
     const requestDefaults = {
@@ -169,7 +184,7 @@ async function queryRequestableAssets(cmd, client, appId, input) {
                         value: {
                             name: name || "",
                             id: id || "",
-                            type: ((_g = item.resource) === null || _g === void 0 ? void 0 : _g.__typename) || ((_h = item.group) === null || _h === void 0 ? void 0 : _h.__typename) || "",
+                            type: entityTypeFromString(((_g = item.resource) === null || _g === void 0 ? void 0 : _g.__typename) || ((_h = item.group) === null || _h === void 0 ? void 0 : _h.__typename)),
                         },
                     };
                 });
@@ -228,7 +243,7 @@ async function queryAssetRoles(cmd, client, assetType, assetId) {
     var _a, _b, _c, _d, _e, _f, _g, _h;
     try {
         switch (assetType) {
-            case "Resource": {
+            case graphql_2.EntityType.Resource: {
                 const resp = await client.query({
                     query: RESOURCE_ROLES_QUERY,
                     variables: {
@@ -257,7 +272,7 @@ async function queryAssetRoles(cmd, client, assetType, assetId) {
                 }
                 return;
             }
-            case "Group": {
+            case graphql_2.EntityType.Group: {
                 const resp = await client.query({
                     query: GROUP_ROLES_QUERY,
                     variables: {
@@ -613,11 +628,14 @@ async function queryAssociatedItems(cmd, client, id, input) {
     }
 }
 // Helper functions
+const selectInstructions = chalk_1.default.dim("[↑↓] Navigate · [Enter] Select · Type to filter");
+const multiSelectInstructions = chalk_1.default.dim("[↑↓] Navigate · [Space] Select · [Enter] Confirm · Type to filter");
 async function selectRequestableItems(cmd, client, requestMap) {
     const initial = (await queryRequestableApps(cmd, client, "")) || [];
     const appPrompt = new AutoComplete({
         name: "App",
-        message: "Select an app:",
+        message: "Select an app",
+        hint: selectInstructions,
         limit: 15,
         choices: initial,
         async suggest(input) {
@@ -645,6 +663,7 @@ async function chooseOktaAzureRoles(cmd, client, app, requestMap) {
     const rolePrompt = new AutoComplete({
         name: "Roles",
         message: `Select a role for ${app.name}:`,
+        hint: multiSelectInstructions,
         limit: 15,
         multiple: true,
         async choices(input) {
@@ -655,7 +674,7 @@ async function chooseOktaAzureRoles(cmd, client, app, requestMap) {
         },
         validate: (answer) => {
             if (answer.length !== 1) {
-                return "You must select only one item.";
+                return "Only one role is allowed to be requested for on Okta or Azure apps.";
             }
             return true;
         },
@@ -667,7 +686,7 @@ async function chooseOktaAzureRoles(cmd, client, app, requestMap) {
             entry.assets[role.id] = {
                 assetId: role.id,
                 assetName: role.name,
-                type: role.type || graphql_2.EntityType.Resource,
+                type: entityTypeFromString(role.type),
                 roles: {},
             };
         }
@@ -683,7 +702,7 @@ function appRolesFromEdge(edge) {
                     value: {
                         id: edge.node.id + accessLevel.accessLevelRemoteId,
                         name: accessLevel.accessLevelName,
-                        type: graphql_2.EntityType.Resource,
+                        type: exports.DISPLAY_LABELS[graphql_2.EntityType.Resource],
                         toString: () => accessLevel.accessLevelName,
                     },
                 }));
@@ -694,7 +713,7 @@ function appRolesFromEdge(edge) {
                     value: {
                         id: edge.node.id,
                         name: (_b = edge.alias) !== null && _b !== void 0 ? _b : edge.node.name,
-                        type: graphql_2.EntityType.Resource,
+                        type: exports.DISPLAY_LABELS[graphql_2.EntityType.Resource],
                         toString: () => { var _a; return (_a = edge.alias) !== null && _a !== void 0 ? _a : edge.node.name; },
                     },
                 },
@@ -703,11 +722,11 @@ function appRolesFromEdge(edge) {
         case "Group":
             return [
                 {
-                    message: (_c = edge.alias) !== null && _c !== void 0 ? _c : edge.node.name,
+                    message: `${(_c = edge.alias) !== null && _c !== void 0 ? _c : edge.node.name} ${graphql_2.EntityType.Group}`,
                     value: {
                         id: edge.node.id,
                         name: (_d = edge.alias) !== null && _d !== void 0 ? _d : edge.node.name,
-                        type: graphql_2.EntityType.Group,
+                        type: exports.DISPLAY_LABELS[graphql_2.EntityType.Group],
                         toString: () => { var _a; return (_a = edge.alias) !== null && _a !== void 0 ? _a : edge.node.name; },
                     },
                 },
@@ -719,6 +738,7 @@ async function chooseAssets(cmd, client, appId, requestMap) {
     const assetPrompt = new AutoComplete({
         name: "Assets",
         message: "Select one or more assets:",
+        hint: multiSelectInstructions,
         limit: 15,
         multiple: true,
         async choices(input) {
@@ -768,6 +788,7 @@ async function chooseRoles(cmd, client, appId, assetId, requestMap) {
     const rolePrompt = new AutoComplete({
         name: "Roles",
         message: `Select one or more roles for ${assetEntry.assetName}:`,
+        hint: multiSelectInstructions,
         limit: 15,
         multiple: true,
         choices: assetRoles,
@@ -858,7 +879,7 @@ async function promptForReason(metadata) {
     const { reason } = await prompt([
         {
             name: "reason",
-            message: "I need access to this because...",
+            message: "Why do you need access?",
             type: "input",
             validate: (answer) => {
                 if (!metadata.requestDefaults.reasonOptional && answer.length < 1) {
@@ -897,6 +918,7 @@ async function promptForExpiration(metadata) {
     const expirationSelect = new AutoComplete({
         name: "expiration",
         message: "When should access expire?",
+        hint: "Type to filter",
         type: "list",
         choices: durations,
         pageSize: 15,
@@ -980,30 +1002,17 @@ async function setCustomDuration(metadata) {
         label: durationLabel,
     };
 }
-async function promptRequestSubmition(cmd, metadata) {
+async function promptRequestSubmission(cmd, metadata) {
     (0, displays_1.displayFinalRequestSummary)(cmd, metadata);
     const submitMessage = "✅ Yes, submit request";
     const cancelMessage = "❌ No, cancel request";
-    const { submit } = await inquirer.prompt([
-        {
-            name: "submit",
-            message: "Submit request?",
-            type: "list",
-            choices: [submitMessage, cancelMessage],
-        },
-    ]);
-    switch (submit) {
-        case submitMessage: {
-            return;
-        }
-        case cancelMessage: {
-            cmd.log("🚫 Access Request has been cancelled.");
-            return;
-        }
-        default: {
-            cmd.error("Unknown error occurred.");
-        }
-    }
+    const prompt = new Select({
+        name: "submitOrCancel",
+        message: "Is this all you want to request?",
+        choices: [submitMessage, cancelMessage],
+    });
+    const submitOrCancel = await prompt.run();
+    return submitOrCancel === submitMessage;
 }
 async function submitFinalRequest(cmd, client, metadata) {
     var _a, _b, _c, _d;
@@ -1015,11 +1024,11 @@ async function submitFinalRequest(cmd, client, metadata) {
         // Both extract the requestedResources and requestedGroups,
         // use different formats.
         for (const [assetId, assetNode] of Object.entries(appNode.assets)) {
-            if (assetNode.roles !== undefined) {
+            if (assetNode.roles) {
                 const mappedRoles = Object.entries(assetNode.roles).map(([roleId, _roleNode]) => {
                     return roleId;
                 });
-                const roleIds = mappedRoles.length ? mappedRoles : [""];
+                const roleIds = mappedRoles.length > 0 ? mappedRoles : [""];
                 for (const roleId of roleIds) {
                     switch (assetNode.type) {
                         case graphql_2.EntityType.Resource: {
@@ -1064,68 +1073,66 @@ async function submitFinalRequest(cmd, client, metadata) {
 async function bypassRequestSelection(cmd, client, flagValue, metadata) {
     var _a, _b;
     try {
-        for (const id of flagValue) {
+        // Query Catalog Item endpoint to identify what the id belongs to (resource or group)
+        for (const val of flagValue) {
+            const delimiterIndex = val.indexOf(":");
+            const assetId = val.substring(0, delimiterIndex);
+            const roleName = val.substring(delimiterIndex + 1);
             const resp = await client.query({
                 query: CATALOG_ITEM,
                 variables: {
-                    uuid: id || "",
+                    uuid: assetId || "",
                 },
                 fetchPolicy: "network-only", // to avoid caching
             });
             switch (resp.data.catalogItem.__typename) {
+                case "Group":
                 case "Resource": {
-                    const resourceName = resp.data.catalogItem.displayName;
-                    const roles = (resp.data.catalogItem.accessLevels || [])
+                    const item = resp.data.catalogItem;
+                    const assetName = item.__typename === "Resource" ? item.displayName : item.name;
+                    const requestableRoles = (item.accessLevels || [])
                         // TODO: Support okta azure apps ?.filter((role) => role.accessLevelName !== "") // This assumes length == 1
                         .map((role) => ({
                         id: role.accessLevelRemoteId,
                         name: role.accessLevelName,
                     }));
-                    if (roles.length > 0 &&
-                        !(roles.length === 1 && roles[0].name === "")) {
-                        cmd.log(`Roles not implemented yet for resource ${resourceName}. Skipping roles selection.`); //TODO: Implement roles support
-                        continue;
-                    }
-                    const appId = ((_a = resp.data.catalogItem.connection) === null || _a === void 0 ? void 0 : _a.id) || "";
+                    const appId = ((_a = item.connection) === null || _a === void 0 ? void 0 : _a.id) || "";
                     if (!(appId in metadata.requestMap)) {
                         metadata.requestMap[appId] = {
-                            appName: ((_b = resp.data.catalogItem.connection) === null || _b === void 0 ? void 0 : _b.displayName) || "",
+                            appName: ((_b = item.connection) === null || _b === void 0 ? void 0 : _b.displayName) || "",
                             appId: appId,
                             assets: {},
                         };
                     }
-                    const assetEntry = metadata.requestMap[appId].assets[id];
+                    const assetEntry = metadata.requestMap[appId].assets[assetId];
                     if (!assetEntry) {
-                        metadata.requestMap[appId].assets[id] = {
-                            assetId: id,
-                            assetName: resourceName,
-                            type: "Resource",
+                        metadata.requestMap[appId].assets[assetId] = {
+                            assetId: assetId,
+                            assetName: assetName,
+                            type: entityTypeFromString(item.__typename),
                             roles: {},
                         };
                     }
-                    if (roles) {
-                        if (!metadata.requestMap[appId].assets[id].roles) {
-                            metadata.requestMap[appId].assets[id].roles = {};
-                        }
-                        for (const role of roles) {
-                            metadata.requestMap[appId].assets[id].roles[role.id] = {
-                                roleId: role.id,
-                                roleName: role.name,
+                    if (requestableRoles.length > 0 &&
+                        !(requestableRoles.length === 1 && requestableRoles[0].name === "")) {
+                        const selectedRole = requestableRoles.find((role) => role.name === roleName);
+                        if (selectedRole !== undefined) {
+                            if (!metadata.requestMap[appId].assets[assetId].roles) {
+                                metadata.requestMap[appId].assets[assetId].roles = {};
+                            }
+                            metadata.requestMap[appId].assets[assetId].roles[selectedRole.id] = {
+                                roleId: selectedRole.id,
+                                roleName: selectedRole.name,
                             };
                         }
+                        else {
+                            cmd.error(`Access level specified does not match one of ${assetName}'s defined access levels: ${requestableRoles.map((role) => `"${role.name}"`)}`);
+                        }
                     }
                     break;
                 }
-                case "Group": {
-                    //TODO
-                    break;
-                }
-                case "Connection": {
-                    //TODO
-                    break;
-                }
                 default:
-                    cmd.error("Unknown error occurred.");
+                    cmd.error("Invalid asset id was passed in using the --id flag.");
             }
         }
     }

package/lib/utils/displays.d.ts

@@ -1,7 +1,7 @@
 import type { ApolloQueryResult } from "@apollo/client";
 import type { Command } from "@oclif/core/lib/command";
 import type { GetRequestQuery, GetRequestsQuery } from "../graphql/graphql";
-import type { RequestMap, RequestMetadata } from "../lib/requests";
+import { type RequestMap, type RequestMetadata } from "../lib/requests";
 export declare function headerMessage(cmd: Command): void;
 export declare function treeifyRequestMap(cmd: Command, requestMap: RequestMap): void;
 export declare function displayFinalRequestSummary(cmd: Command, metadata: RequestMetadata): void;

package/lib/utils/displays.js

@@ -7,6 +7,7 @@ exports.getStyledStatus = getStyledStatus;
 exports.displayRequestDetails = displayRequestDetails;
 exports.displayRequestListTable = displayRequestListTable;
 const chalk_1 = require("chalk");
+const requests_1 = require("../lib/requests");
 const Table = require("cli-table3");
 const treeify = require("object-treeify").default;
 function headerMessage(cmd) {
@@ -30,7 +31,7 @@ function treeifyRequestMap(cmd, requestMap) {
         for (const [_assetId, assetNode] of Object.entries(appNode.assets)) {
             // If okta/azure asset with no role, change asset name
             const assetName = assetNode.assetName || "No Role (Direct access)";
-            const assetKey = `${assetName} ${chalk_1.default.dim(`[${assetNode.type}]`)}`;
+            const assetKey = `${assetName} ${chalk_1.default.dim(`[${requests_1.DISPLAY_LABELS[assetNode.type]}]`)}`;
             if (assetNode.roles !== undefined) {
                 assetsTree[assetKey] = {};
                 for (const [_roleId, roleNode] of Object.entries(assetNode.roles)) {

package/oclif.manifest.json

@@ -316,6 +316,34 @@
         "set-url.js"
       ]
     },
+    "whoami": {
+      "aliases": [],
+      "args": {},
+      "description": "Describes current url set, organization name, and logged in user if applicabled.",
+      "flags": {
+        "help": {
+          "char": "h",
+          "description": "Show CLI help.",
+          "name": "help",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "whoami",
+      "pluginAlias": "opal-security",
+      "pluginName": "opal-security",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "lib",
+        "commands",
+        "whoami.js"
+      ]
+    },
     "aws:identity": {
       "aliases": [],
       "args": {},
@@ -388,14 +416,14 @@
         "get.js"
       ]
     },
-    "iam-roles:start": {
+    "kube-roles:start": {
       "aliases": [],
       "args": {},
-      "description": "Starts a session to assume an IAM role.",
+      "description": "Starts a session to assume a Kubernetes cluster IAM role.",
       "examples": [
-        "opal iam-roles:start",
-        "opal iam-roles:start --id 51f7176b-0464-4a6f-8369-e951e187b398",
-        "opal iam-roles:start --id 51f7176b-0464-4a6f-8369-e951e187b398 --profileName \"custom-profile\""
+        "opal kube-roles:start",
+        "opal kube-roles:start --id 51f7176b-0464-4a6f-8369-e951e187b398",
+        "opal kube-roles:start --id 51f7176b-0464-4a6f-8369-e951e187b398 --accessLevelRemoteId \"arn:aws:iam::712234975475:role/acme-eks-cluster-admin-role\""
       ],
       "flags": {
         "help": {
@@ -413,6 +441,14 @@
           "multiple": false,
           "type": "option"
         },
+        "accessLevelRemoteId": {
+          "char": "a",
+          "description": "The remote ID of the access level with which to access the resource.",
+          "name": "accessLevelRemoteId",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "sessionId": {
           "char": "s",
           "description": "The Opal ID of the session to connect to. Uses an existing session that was created via the web flow.",
@@ -427,18 +463,11 @@
           "name": "refresh",
           "allowNo": false,
           "type": "boolean"
-        },
-        "profileName": {
-          "description": "Uses a custom AWS profile name for the IAM role. Default value is the role's name.",
-          "name": "profileName",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "iam-roles:start",
+      "id": "kube-roles:start",
       "pluginAlias": "opal-security",
       "pluginName": "opal-security",
       "pluginType": "core",
@@ -448,18 +477,18 @@
       "relativePath": [
         "lib",
         "commands",
-        "iam-roles",
+        "kube-roles",
         "start.js"
       ]
     },
-    "kube-roles:start": {
+    "iam-roles:start": {
       "aliases": [],
       "args": {},
-      "description": "Starts a session to assume a Kubernetes cluster IAM role.",
+      "description": "Starts a session to assume an IAM role.",
       "examples": [
-        "opal kube-roles:start",
-        "opal kube-roles:start --id 51f7176b-0464-4a6f-8369-e951e187b398",
-        "opal kube-roles:start --id 51f7176b-0464-4a6f-8369-e951e187b398 --accessLevelRemoteId \"arn:aws:iam::712234975475:role/acme-eks-cluster-admin-role\""
+        "opal iam-roles:start",
+        "opal iam-roles:start --id 51f7176b-0464-4a6f-8369-e951e187b398",
+        "opal iam-roles:start --id 51f7176b-0464-4a6f-8369-e951e187b398 --profileName \"custom-profile\""
       ],
       "flags": {
         "help": {
@@ -477,14 +506,6 @@
           "multiple": false,
           "type": "option"
         },
-        "accessLevelRemoteId": {
-          "char": "a",
-          "description": "The remote ID of the access level with which to access the resource.",
-          "name": "accessLevelRemoteId",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "sessionId": {
           "char": "s",
           "description": "The Opal ID of the session to connect to. Uses an existing session that was created via the web flow.",
@@ -499,11 +520,18 @@
           "name": "refresh",
           "allowNo": false,
           "type": "boolean"
+        },
+        "profileName": {
+          "description": "Uses a custom AWS profile name for the IAM role. Default value is the role's name.",
+          "name": "profileName",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "kube-roles:start",
+      "id": "iam-roles:start",
       "pluginAlias": "opal-security",
       "pluginName": "opal-security",
       "pluginType": "core",
@@ -513,7 +541,7 @@
       "relativePath": [
         "lib",
         "commands",
-        "kube-roles",
+        "iam-roles",
         "start.js"
       ]
     },
@@ -606,10 +634,10 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "id": {
-          "char": "i",
-          "description": "The id of the asset (resource, group) to request access to. Append a role ID using a colon if needed, e.g. `--id 123:456`.        \n If not provided, an interactive selection flow will be available to select assets to request.",
-          "name": "id",
+        "assets": {
+          "char": "a",
+          "description": "The ids of the assets (resource, group) to request access to. Append a role ID using a colon if needed, e.g. `--assets 123:456`.        \n If not provided, an interactive selection flow will be available to select assets to request.",
+          "name": "assets",
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
@@ -632,7 +660,6 @@
         }
       },
       "hasDynamicHelp": false,
-      "hidden": true,
       "hiddenAliases": [],
       "id": "request:create",
       "pluginAlias": "opal-security",
@@ -681,7 +708,6 @@
         }
       },
       "hasDynamicHelp": false,
-      "hidden": true,
       "hiddenAliases": [],
       "id": "request:get",
       "pluginAlias": "opal-security",
@@ -740,7 +766,6 @@
         }
       },
       "hasDynamicHelp": false,
-      "hidden": true,
       "hiddenAliases": [],
       "id": "request:list",
       "pluginAlias": "opal-security",
@@ -1003,5 +1028,5 @@
       ]
     }
   },
-  "version": "3.1.1-beta.7cc0a74"
+  "version": "3.1.1-beta.7e1cc21"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "opal-security",
   "description": "Opal allows you to centrally manage access to all of your sensitive systems.",
-  "version": "3.1.1-beta.7cc0a74",
+  "version": "3.1.1-beta.7e1cc21",
   "author": "Stephen Cobbe",
   "bin": {
     "opal": "./bin/run"