Server Manager 3 Preview

Preview

Please note, that in long description you should mention: • App's goals and functions • How to use the app • If it is open source app - please, provide the installation instructions

Previous value: `https://github.com/gjsjohnmurray/intersystems-servermanager`

Previous value: `Server Manager 3 Preview`

Previous value: `https://marketplace.visualstudio.com/items?itemName=intersystems-community.servermanager`

Previous value: `Download`

Previous value: `Developer Environment`

Previous value: `InterSystems IRIS, InterSystems IRIS for Health, HealthShare, Caché, Ensemble`

Previous value: ``

Previous value: `Not checked`

Previous value: `Now an Authentication Provider for VS Code, for better security`

Previous value: `A preview of version 3 of the [InterSystems Server Manager](https://openexchange.intersystems.com/package/Server-Manager-for-VSCode) extension for Visual Studio Code which improves the security of stored passwords by integrating with VS Code's [Authentication Provider API](https://code.visualstudio.com/api/references/vscode-api#AuthenticationProvider). This significant new release took part in the [November 2021 InterSystems Security Contest](https://openexchange.intersystems.com/contest/19). > 2021-12-02: **This is currently a pre-release extension.** > Read [this article](https://community.intersystems.com/post/server-manager-now-showcasing-vs-codes-new-support-pre-release-extensions) about how to use VS Code's new pre-release mechanism. > Thanks to [George James Software](https://georgejames.com) for backing this development effort. ## The Authentication Provider Since version 2, Server Manager has enabled you to store connection passwords in the native keystore of your workstation's operating system. This was a more secure alternative to you putting them as plaintext in your JSON files. However, the `getServerSpec` function in Server Manager 2's API allowed **any** installed extension to obtain these stored passwords without requiring your permission. VS Code's Authentication Provider API, introduced in version 1.54 ([February 2021](https://code.visualstudio.com/updates/v1_54#_authentication-provider-api)) is now (version 1.63) mature enough for us to use. Server Manager 3 does the following: 1. Implements an authentication provider called 'intersystems-server-credentials'. 2. Uses this authentication provider when accessing servers from its own Server Tree. 3. No longer returns passwords to callers of `getServerSpec`. > Items #2 and #3 have implications regarding backward compatibility. An interim legacy mode is available to help with the transition. ### Signing In The first time you expand a server in the tree VS Code displays a modal dialog asking for your permission:  If you allow this and your server definition in `intersystems.servers` does not specify a `username` the next step is:  If you proceed, or if this step was skipped because your server definition includes a username, the next step is:  If you click the 'key' button after typing your password it will be saved securely in your workstation keychain, from where the 'InterSystems Server Credentials' authentication provider will be able to retrieve it after you restart VS Code. If instead you press 'Enter' the password will be available only until you restart VS Code. Either way, you are now signed in on the specified account. ### Trusting Other Extensions When another extension first asks to use an InterSystems Server Credentials account you must either allow this or deny it. For example, with a [**pre-release VSIX of the InterSystems ObjectScript extension**](https://georgejames.com/files/vscode-objectscript-1.1.2-SNAPSHOT-authentication-provider-20211126.vsix) that uses the new authentication provider you will get this after you click the edit pencil button alongside a namespace in the Server Manager tree:  ### Managing Signed In Accounts You can use the menu of VS Code's Accounts icon in the activity bar to manage your signed in accounts:  The 'Manage Trusted Extensions' option lets you remove an extension from the list of those you previously granted access to this InterSystems Server Credentials account:  The 'Sign Out' option lets you sign out this account after confirmation:  When signing out an account for which you previously saved the password will get an option to delete the password, unless you have altered the `intersystemsServerManager.credentialsProvider.deletePasswordOnSignout` setting:  ### Legacy Mode Server Manager 3 makes changes which may degrade the user experience relative to version 2. To revert, make this user-level setting: ```json "intersystemsServerManager.authentication.provider": "none" ``` Please only use this as a short term measure until extensions that use the Server Manager `getServerSpec` API get updated to use the 'intersystems-server-credentials' authentication provider. The setting may be removed in a future release.`

Previous value: `https://github.com/gjsjohnmurray/intersystems-servermanager/blob/main/LICENSE`

Previous value: `https://community.intersystems.com/post/previewing-server-manager-30-vs-code`

Previous image: