asciidoc for credential extension added Project: http://git-wip-us.apache.org/repos/asf/ant-ivyde/repo Commit: http://git-wip-us.apache.org/repos/asf/ant-ivyde/commit/675f141b Tree: http://git-wip-us.apache.org/repos/asf/ant-ivyde/tree/675f141b Diff: http://git-wip-us.apache.org/repos/asf/ant-ivyde/diff/675f141b
Branch: refs/heads/master Commit: 675f141ba4edc73a2858c91609a93034f1c8a504 Parents: 6eb38cd Author: alex-bl <alexander.bl...@arctis.at> Authored: Sat Jul 8 16:46:08 2017 +0200 Committer: alex-bl <alexander.bl...@arctis.at> Committed: Sat Jul 8 16:46:08 2017 +0200 ---------------------------------------------------------------------- doc/src/credentialsExtension.adoc | 92 +++++++++++++++++++ .../images/sec_add_credentials_duplicate.png | Bin 0 -> 80887 bytes .../sec_add_credentials_duplicate_resolved.png | Bin 0 -> 83558 bytes doc/src/images/sec_add_credentials_empty.png | Bin 0 -> 75105 bytes doc/src/images/sec_add_credentials_filled.png | Bin 0 -> 80880 bytes doc/src/images/sec_add_credentials_overview.png | Bin 0 -> 51728 bytes .../images/sec_edit_credentials_completed.png | Bin 0 -> 89224 bytes doc/src/images/sec_edit_credentials_init.png | Bin 0 -> 54422 bytes .../images/sec_edit_credentials_overview.png | Bin 0 -> 55750 bytes doc/src/images/sec_remove_credentials.png | Bin 0 -> 80841 bytes doc/src/images/sec_secure_storage_pwd.png | Bin 0 -> 17450 bytes doc/src/images/sec_security_preferences.png | Bin 0 -> 48980 bytes 12 files changed, 92 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/ant-ivyde/blob/675f141b/doc/src/credentialsExtension.adoc ---------------------------------------------------------------------- diff --git a/doc/src/credentialsExtension.adoc b/doc/src/credentialsExtension.adoc new file mode 100644 index 0000000..efaf6c4 --- /dev/null +++ b/doc/src/credentialsExtension.adoc @@ -0,0 +1,92 @@ +//// + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. +//// + +== [[security]]Security + +This preference section allows you to manage credentials, which the ivy dependency manager needs to access protected repositories. The credentials are directly stored into the Eclipse Secure storage and loaded during the ivyDE-plugin's startup. This preference page allows you to manage your ivy credentials safely without the need to "publish" them in plain-text inside your build-files. + +== [[general]]General workflow + +The ivyDE credentials extension allows you - as already mentioned - to protect your ivy credentials by using the Eclipse Secure storage. The credential entries are only maintained by the Eclipse secure storage itself: Every operation (add/edit/remove) is directly performed on the Eclipse secure storage without any intermediate caches. At the ivyDE plugin's startup, the Eclipse Secure storage is accessed (this operation requires you to insert your password if your Eclipse Secure storage is password-protected) and all the credential entries - which are related to the ivy dependency manager - are loaded and copied to the internal ivy credential manager (where ivy looks for credentials in case of protected repositories). + +Please note that this "credential-copying" is directly done after the ivyDE plugin's startup. If your ivy-configuration files, respectively, your build-files also contain credentials pointing to the same repository (same host@realm combination as already stored in the Eclipse Secure storage), the credentials inside the Eclipse Secure storage may be overwritten due to the fact, that credentials specified within the mentioned alternative locations may be added to the internal ivy credential manager after the "credential-copying" was performed. + +.General: + +== [[credentialsOverview]]Overview + +In this view all your credentials related to the ivy dependency manager are listed. The credentials consist of: + +* Host: The host of your protected repository. + +* Realm: The realm of your protected repository. + +* Username: The username which grants access to the protected repository. + +* Pwd: The password to identify yourself. + +You can either add new credentials or edit/remove existing ones (see next sections). + +image::images/sec_security_preferences.png[] + +== [[addCredentials]]Add new credentials + +Click on the "Add..." button to add new credentials: + +image::images/sec_add_credentials_empty.png[] + +A new dialog appears where you can insert a new credential entry. The properties "Host" and "Realm" are required because they are used to identify an artifact-repository and thus also a credential entry within the Eclipse secure storage. The property "Id" is read-only and shows you the repository's identifier (host@realm). + +image::images/sec_add_credentials_filled.png[] + +If the inserted host@realm combination is unique and not already existing, the credential entry can be saved (stored directly to the Eclipse Secure storage). Press "OK" to save, "Cancel" otherwise. + +The added credential entry is now visible within the overview and can be edited or removed: + +image::images/sec_add_credentials_overview.png[] + +Adding a new credential entry having the same identifier is not permitted (as mentioned before): + +image::images/sec_add_credentials_duplicate.png[] + +The ivy dependency manager allows multiple repositories for the same host, but their realm has to be unique on that host: + +image::images/sec_add_credentials_duplicate_resolved.png[] + +== [[editCredentials]]Edit existing credentials + +Once credentials are added to the Eclipse Secure storage, they can be edited. To edit a credential entry, select the desired entry (row) listed in the overview and press "Edit...": + +image::images/sec_edit_credentials_init.png[] + +Afterwards the edit dialog appears. Press "OK" to save your changes or "Cancel" to discard your changes: + +image::images/sec_edit_credentials_completed.png[] + +If you saved your changes, the credential entry inside the Eclipse Secure storage is updated and the credential overview is refreshed: + +image::images/sec_edit_credentials_overview.png[] + +== [[editCredentials]]Remove existing credentials + +In the credentials overview press "Remove" to delete the selected credential entry. Press "OK" to confirm or "Cancel" to abort the operation: + +image::images/sec_remove_credentials.png[] + +Please note that the internal ivyDE credentials manager (currently) does not permit to delete credentials once they are loaded at startup. If you delete credentials entries, the corresponding entries in the internal ivyDE credentials manager are invalidated (password and username are nulled). After Eclipse is restarted, the the internal ivyDE credentials manager is rebuild. \ No newline at end of file http://git-wip-us.apache.org/repos/asf/ant-ivyde/blob/675f141b/doc/src/images/sec_add_credentials_duplicate.png ---------------------------------------------------------------------- diff --git a/doc/src/images/sec_add_credentials_duplicate.png b/doc/src/images/sec_add_credentials_duplicate.png new file mode 100644 index 0000000..775891a Binary files /dev/null and b/doc/src/images/sec_add_credentials_duplicate.png differ http://git-wip-us.apache.org/repos/asf/ant-ivyde/blob/675f141b/doc/src/images/sec_add_credentials_duplicate_resolved.png ---------------------------------------------------------------------- diff --git a/doc/src/images/sec_add_credentials_duplicate_resolved.png b/doc/src/images/sec_add_credentials_duplicate_resolved.png new file mode 100644 index 0000000..eeaba21 Binary files /dev/null and b/doc/src/images/sec_add_credentials_duplicate_resolved.png differ http://git-wip-us.apache.org/repos/asf/ant-ivyde/blob/675f141b/doc/src/images/sec_add_credentials_empty.png ---------------------------------------------------------------------- diff --git a/doc/src/images/sec_add_credentials_empty.png b/doc/src/images/sec_add_credentials_empty.png new file mode 100644 index 0000000..6d59c12 Binary files /dev/null and b/doc/src/images/sec_add_credentials_empty.png differ http://git-wip-us.apache.org/repos/asf/ant-ivyde/blob/675f141b/doc/src/images/sec_add_credentials_filled.png ---------------------------------------------------------------------- diff --git a/doc/src/images/sec_add_credentials_filled.png b/doc/src/images/sec_add_credentials_filled.png new file mode 100644 index 0000000..482367f Binary files /dev/null and b/doc/src/images/sec_add_credentials_filled.png differ http://git-wip-us.apache.org/repos/asf/ant-ivyde/blob/675f141b/doc/src/images/sec_add_credentials_overview.png ---------------------------------------------------------------------- diff --git a/doc/src/images/sec_add_credentials_overview.png b/doc/src/images/sec_add_credentials_overview.png new file mode 100644 index 0000000..06535ce Binary files /dev/null and b/doc/src/images/sec_add_credentials_overview.png differ http://git-wip-us.apache.org/repos/asf/ant-ivyde/blob/675f141b/doc/src/images/sec_edit_credentials_completed.png ---------------------------------------------------------------------- diff --git a/doc/src/images/sec_edit_credentials_completed.png b/doc/src/images/sec_edit_credentials_completed.png new file mode 100644 index 0000000..766aae5 Binary files /dev/null and b/doc/src/images/sec_edit_credentials_completed.png differ http://git-wip-us.apache.org/repos/asf/ant-ivyde/blob/675f141b/doc/src/images/sec_edit_credentials_init.png ---------------------------------------------------------------------- diff --git a/doc/src/images/sec_edit_credentials_init.png b/doc/src/images/sec_edit_credentials_init.png new file mode 100644 index 0000000..1571733 Binary files /dev/null and b/doc/src/images/sec_edit_credentials_init.png differ http://git-wip-us.apache.org/repos/asf/ant-ivyde/blob/675f141b/doc/src/images/sec_edit_credentials_overview.png ---------------------------------------------------------------------- diff --git a/doc/src/images/sec_edit_credentials_overview.png b/doc/src/images/sec_edit_credentials_overview.png new file mode 100644 index 0000000..c09dc28 Binary files /dev/null and b/doc/src/images/sec_edit_credentials_overview.png differ http://git-wip-us.apache.org/repos/asf/ant-ivyde/blob/675f141b/doc/src/images/sec_remove_credentials.png ---------------------------------------------------------------------- diff --git a/doc/src/images/sec_remove_credentials.png b/doc/src/images/sec_remove_credentials.png new file mode 100644 index 0000000..9dce966 Binary files /dev/null and b/doc/src/images/sec_remove_credentials.png differ http://git-wip-us.apache.org/repos/asf/ant-ivyde/blob/675f141b/doc/src/images/sec_secure_storage_pwd.png ---------------------------------------------------------------------- diff --git a/doc/src/images/sec_secure_storage_pwd.png b/doc/src/images/sec_secure_storage_pwd.png new file mode 100644 index 0000000..773059f Binary files /dev/null and b/doc/src/images/sec_secure_storage_pwd.png differ http://git-wip-us.apache.org/repos/asf/ant-ivyde/blob/675f141b/doc/src/images/sec_security_preferences.png ---------------------------------------------------------------------- diff --git a/doc/src/images/sec_security_preferences.png b/doc/src/images/sec_security_preferences.png new file mode 100644 index 0000000..5003617 Binary files /dev/null and b/doc/src/images/sec_security_preferences.png differ
