mirror of
https://github.com/JetBrains/intellij-sdk-code-samples.git
synced 2025-07-29 01:37:51 +08:00
4e802980f2
* [webhelp] Fixes for TXP00152, TXP00002, test build 27 Jul 22:26 * [webhelp] Fixes for Part #4 TXP00010, EXCEPT decimal numbers in section titles * [webhelp] Fixes for Part #5 TXP00017 * [webhelp] Fixes for Part #4 TXP00010 - removed numbers from page section titles in "Custom Language Support Tutorial" and "Testing a Custom Language Plugin". * [webhelp] Removed numbers from page section titles in rest of project *.md files. * [new webhelp] Build #44 changes * [new webhelp] Maintenance merge from master * [new webhelp] Add placeholder file for webhelp import. * [webhelp] Correct redirects for file name changes * [webhelp] TOC not needed in webhelp * [format] {:toc} not needed for webhelp * add {:disable-links} to ensure demo links are not interpreted as real links. * Put all badges on the same line to simplify composition. * formatter.md: fix upsource link * fix some links * api_changes_list.md: remove note * migrate to webhelp - initial * fix GH edit URL * remove sdkdocs-template setup in VCS config * remove recently_updated.md * restore COC/CONTRIBUTING.md * api_changes_list.md: remove note * useful_links.md: IPE Co-authored-by: JohnHake <john.hake@jetbrains.com> Co-authored-by: Yann Cébron <yann.cebron@jetbrains.com>
53 lines
2.2 KiB
Markdown
53 lines
2.2 KiB
Markdown
[//]: # (title: Persisting Sensitive Data)
|
|
|
|
<!-- Copyright 2000-2020 JetBrains s.r.o. and other contributors. Use of this source code is governed by the Apache 2.0 license that can be found in the LICENSE file. -->
|
|
|
|
The Credentials Store API allows you to store sensitive user data securely, like passwords, server URLs, etc.
|
|
|
|
## How to Use
|
|
Use [`PasswordSafe`](upsource:///platform/platform-api/src/com/intellij/ide/passwordSafe/PasswordSafe.kt) to work with credentials.
|
|
|
|
### Retrieve Stored Credentials
|
|
|
|
```java
|
|
String key = null; // e.g. serverURL, accountID
|
|
CredentialAttributes credentialAttributes = createCredentialAttributes(key);
|
|
|
|
Credentials credentials = PasswordSafe.getInstance().get(credentialAttributes);
|
|
if (credentials != null) {
|
|
String password = credentials.getPasswordAsString();
|
|
}
|
|
|
|
// or get password only
|
|
String password = PasswordSafe.getInstance().getPassword(credentialAttributes);
|
|
|
|
private CredentialAttributes createCredentialAttributes(String key) {
|
|
return new CredentialAttributes(CredentialAttributesKt.generateServiceName("MySystem", key));
|
|
}
|
|
```
|
|
|
|
### Store Credentials
|
|
|
|
```java
|
|
CredentialAttributes credentialAttributes = createCredentialAttributes(serverId); // see previous sample
|
|
Credentials credentials = new Credentials(username, password);
|
|
PasswordSafe.getInstance().set(credentialAttributes, credentials);
|
|
```
|
|
|
|
To remove stored credentials, pass `null` for the `credentials` parameter.
|
|
|
|
## Storage
|
|
The default storage format depends on the OS.
|
|
|
|
| OS | Storage |
|
|
| ------- | ----------------------------------------------------- |
|
|
| Windows | File in [KeePass][Windows] format |
|
|
| macOS | Keychain using [Security Framework][macOS] |
|
|
| Linux | [Secret Service API][linux] using [libsecret][linux2] |
|
|
|
|
[Windows]: https://keepass.info
|
|
[macOS]: https://developer.apple.com/documentation/security/keychain_services
|
|
[linux]: https://specifications.freedesktop.org/secret-service/latest/
|
|
[linux]: https://wiki.gnome.org/Projects/Libsecret
|
|
|
|
Users can override the default behavior in Preferences \| Appearance & Behavior \| System Settings \| Passwords. |