You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@ant.apache.org by hi...@apache.org on 2017/07/11 20:52:32 UTC
[3/7] ant-ivyde git commit: asciidoc for credential extension added
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 <al...@arctis.at>
Authored: Sat Jul 8 16:46:08 2017 +0200
Committer: alex-bl <al...@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