[3/4] brooklyn-docs git commit: Describe authentication in brooklyn.libraries

[dr...@apache.org]

Describe authentication in brooklyn.libraries


Project: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/commit/bc0b1d87
Tree: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/tree/bc0b1d87
Diff: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/diff/bc0b1d87

Branch: refs/heads/master
Commit: bc0b1d871494f122a548cbf8c6609fa2fc1ebcf6
Parents: e2711a9
Author: Sam Corbett <sa...@cloudsoftcorp.com>
Authored: Tue Dec 19 14:48:55 2017 +0000
Committer: Sam Corbett <sa...@cloudsoftcorp.com>
Committed: Tue Dec 19 14:54:40 2017 +0000

----------------------------------------------------------------------
 guide/blueprints/catalog/schema.md | 8 ++++++++
 1 file changed, 8 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/brooklyn-docs/blob/bc0b1d87/guide/blueprints/catalog/schema.md
----------------------------------------------------------------------
diff --git a/guide/blueprints/catalog/schema.md b/guide/blueprints/catalog/schema.md
index d08d739..467399c 100644
--- a/guide/blueprints/catalog/schema.md
+++ b/guide/blueprints/catalog/schema.md
@@ -158,6 +158,9 @@ brooklyn.libraries:
 - name: "symbolic-name"
   version: "1.0"
   url: "http://example.com/bundle-1.0.jar"
+  auth:
+    username: $brooklyn:external("myprovider", "username")
+    password: $brooklyn:external("myprovider", "password")
 ~~~
 The only mandatory property in the long form is `url`. Brooklyn will skip the download when a bundle with matching `name` and `version` is already installed.
 
@@ -167,6 +170,11 @@ whenever a bundle is reloaded in a Brooklyn server,
 and if entities have been deployed against that version, their behavior may change in subtle or potentially incompatible ways.
 To avoid this situation, it is highly recommended to use OSGi version stamps as part of the URL.
 
+Specify `auth` if the resource at `url` requires authentication to access.
+Do not write the username and password directly into the file; instead
+use [external configuration]({{book.path.docs}}/ops/externalized-configuration.md)
+to reference the values.
+
 **`include`**
 A URL to another catalog file to include, inheriting the meta from the current hierarchy.
 Libraries defined so far in the meta will be used to load classpath entries. `include` must be used