)]}'
{"v3/src/markdown/identity-api-v3-os-rest-config-ext.md":[{"author":{"_account_id":220,"name":"Haneef Ali","email":"haneef.ali@hp.com","username":"haneef"},"change_message_id":"48c3178d8808be2244f33fc798be09af6956d0e8","unresolved":false,"context_lines":[{"line_number":37,"context_line":"The following additional APIs are supported by this extension:"},{"line_number":38,"context_line":""},{"line_number":39,"context_line":"#### Get current values of configuration options:"},{"line_number":40,"context_line":"`GET /OS-REST-CONFIG/config`"},{"line_number":41,"context_line":""},{"line_number":42,"context_line":"The actual contents of the response may vary depending on the version of the"},{"line_number":43,"context_line":"identity service being run, but a typical response is shown below:"}],"source_content_type":"text/x-markdown","patch_set":1,"id":"baada198_9fe08227","line":40,"updated":"2014-07-14 20:35:56.000000000","message":"Who can invoke this operation?","commit_id":"04a0f304f8fcc805ccbf2c1eb85f16f781fe0adc"},{"author":{"_account_id":5707,"name":"Henry Nash","email":"henryn@linux.vnet.ibm.com","username":"henry-nash"},"change_message_id":"8ec8352f7c65a3b45eb58ad282484d997bfa6d81","unresolved":false,"context_lines":[{"line_number":37,"context_line":"The following additional APIs are supported by this extension:"},{"line_number":38,"context_line":""},{"line_number":39,"context_line":"#### Get current values of configuration options:"},{"line_number":40,"context_line":"`GET /OS-REST-CONFIG/config`"},{"line_number":41,"context_line":""},{"line_number":42,"context_line":"The actual contents of the response may vary depending on the version of the"},{"line_number":43,"context_line":"identity service being run, but a typical response is shown below:"}],"source_content_type":"text/x-markdown","patch_set":1,"id":"baada198_2c2d8fa8","line":40,"in_reply_to":"baada198_1f5c727c","updated":"2014-07-15 00:25:58.000000000","message":"Yes, it\u0027s controlled by policy in the normal way - the default is \"admin_requried\"","commit_id":"04a0f304f8fcc805ccbf2c1eb85f16f781fe0adc"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"2b436e2a8235c22d23f54e577b6807cd96b77c76","unresolved":false,"context_lines":[{"line_number":37,"context_line":"The following additional APIs are supported by this extension:"},{"line_number":38,"context_line":""},{"line_number":39,"context_line":"#### Get current values of configuration options:"},{"line_number":40,"context_line":"`GET /OS-REST-CONFIG/config`"},{"line_number":41,"context_line":""},{"line_number":42,"context_line":"The actual contents of the response may vary depending on the version of the"},{"line_number":43,"context_line":"identity service being run, but a typical response is shown below:"}],"source_content_type":"text/x-markdown","patch_set":1,"id":"baada198_1f5c727c","line":40,"in_reply_to":"baada198_9fe08227","updated":"2014-07-14 20:50:38.000000000","message":"it should be admin only","commit_id":"04a0f304f8fcc805ccbf2c1eb85f16f781fe0adc"},{"author":{"_account_id":220,"name":"Haneef Ali","email":"haneef.ali@hp.com","username":"haneef"},"change_message_id":"48c3178d8808be2244f33fc798be09af6956d0e8","unresolved":false,"context_lines":[{"line_number":48,"context_line":""},{"line_number":49,"context_line":"    {"},{"line_number":50,"context_line":"        \"config\": {"},{"line_number":51,"context_line":"            \"admin_bind_host\": \"0.0.0.0\","},{"line_number":52,"context_line":"            \"admin_endpoint\": null,"},{"line_number":53,"context_line":"            \"admin_port\": 35357,"},{"line_number":54,"context_line":"            \"admin_token\": \"**********\","}],"source_content_type":"text/x-markdown","patch_set":1,"id":"baada198_7f8e4e7a","line":51,"updated":"2014-07-14 20:35:56.000000000","message":"Doesn\u0027t this fall under \"DEFAULT\" group?","commit_id":"04a0f304f8fcc805ccbf2c1eb85f16f781fe0adc"},{"author":{"_account_id":5707,"name":"Henry Nash","email":"henryn@linux.vnet.ibm.com","username":"henry-nash"},"change_message_id":"8ec8352f7c65a3b45eb58ad282484d997bfa6d81","unresolved":false,"context_lines":[{"line_number":48,"context_line":""},{"line_number":49,"context_line":"    {"},{"line_number":50,"context_line":"        \"config\": {"},{"line_number":51,"context_line":"            \"admin_bind_host\": \"0.0.0.0\","},{"line_number":52,"context_line":"            \"admin_endpoint\": null,"},{"line_number":53,"context_line":"            \"admin_port\": 35357,"},{"line_number":54,"context_line":"            \"admin_token\": \"**********\","}],"source_content_type":"text/x-markdown","patch_set":1,"id":"baada198_cf0a451f","line":51,"in_reply_to":"baada198_7f8e4e7a","updated":"2014-07-15 00:25:58.000000000","message":"yes....I guess we have two ways we could access these - one would be to pretend there is a group called \"default\" (which isn\u0027t how config is laid out)...or just let them access it with\n\nGET /OS-CONFIG/config/option/admin_bind_host (for example)","commit_id":"04a0f304f8fcc805ccbf2c1eb85f16f781fe0adc"},{"author":{"_account_id":220,"name":"Haneef Ali","email":"haneef.ali@hp.com","username":"haneef"},"change_message_id":"48c3178d8808be2244f33fc798be09af6956d0e8","unresolved":false,"context_lines":[{"line_number":392,"context_line":"Configuration options that are marked as secret will have their values"},{"line_number":393,"context_line":"obfuscated, for example see the ``admin_token`` option in the above example."},{"line_number":394,"context_line":""},{"line_number":395,"context_line":"A specific group or option can also be specified in the url to retrieve a"},{"line_number":396,"context_line":"subset of the configuration options. For example to retrieve the options in"},{"line_number":397,"context_line":"the ``token`` group:"},{"line_number":398,"context_line":""}],"source_content_type":"text/x-markdown","patch_set":1,"id":"baada198_5f6fca91","line":395,"updated":"2014-07-14 20:35:56.000000000","message":"Is secret the only value this that is obfuscated?\n\nDo we have any security implication revealing the host names?  e.g where mysql/rabitmq server runs etc?","commit_id":"04a0f304f8fcc805ccbf2c1eb85f16f781fe0adc"},{"author":{"_account_id":5707,"name":"Henry Nash","email":"henryn@linux.vnet.ibm.com","username":"henry-nash"},"change_message_id":"8ec8352f7c65a3b45eb58ad282484d997bfa6d81","unresolved":false,"context_lines":[{"line_number":392,"context_line":"Configuration options that are marked as secret will have their values"},{"line_number":393,"context_line":"obfuscated, for example see the ``admin_token`` option in the above example."},{"line_number":394,"context_line":""},{"line_number":395,"context_line":"A specific group or option can also be specified in the url to retrieve a"},{"line_number":396,"context_line":"subset of the configuration options. For example to retrieve the options in"},{"line_number":397,"context_line":"the ``token`` group:"},{"line_number":398,"context_line":""}],"source_content_type":"text/x-markdown","patch_set":1,"id":"baada198_4f16354a","line":395,"in_reply_to":"baada198_5f6fca91","updated":"2014-07-15 00:25:58.000000000","message":"secret isn\u0027t a value...it\u0027s an attribute you can define for any individual option in config..any with that attribute will be obfuscated","commit_id":"04a0f304f8fcc805ccbf2c1eb85f16f781fe0adc"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"2b436e2a8235c22d23f54e577b6807cd96b77c76","unresolved":false,"context_lines":[{"line_number":396,"context_line":"subset of the configuration options. For example to retrieve the options in"},{"line_number":397,"context_line":"the ``token`` group:"},{"line_number":398,"context_line":""},{"line_number":399,"context_line":"`GET /OS-REST-CONFIG/config/group/token`"},{"line_number":400,"context_line":""},{"line_number":401,"context_line":"Response:"},{"line_number":402,"context_line":""}],"source_content_type":"text/x-markdown","patch_set":1,"id":"baada198_df9afa12","line":399,"updated":"2014-07-14 20:50:38.000000000","message":"I think leveraging query parameters will make it easier to add in more values as we go along.","commit_id":"04a0f304f8fcc805ccbf2c1eb85f16f781fe0adc"},{"author":{"_account_id":5707,"name":"Henry Nash","email":"henryn@linux.vnet.ibm.com","username":"henry-nash"},"change_message_id":"8ec8352f7c65a3b45eb58ad282484d997bfa6d81","unresolved":false,"context_lines":[{"line_number":396,"context_line":"subset of the configuration options. For example to retrieve the options in"},{"line_number":397,"context_line":"the ``token`` group:"},{"line_number":398,"context_line":""},{"line_number":399,"context_line":"`GET /OS-REST-CONFIG/config/group/token`"},{"line_number":400,"context_line":""},{"line_number":401,"context_line":"Response:"},{"line_number":402,"context_line":""}],"source_content_type":"text/x-markdown","patch_set":1,"id":"baada198_0f3efdb7","line":399,"in_reply_to":"baada198_df9afa12","updated":"2014-07-15 00:25:58.000000000","message":"Maybe...but see my comment in the spec. I originally had it done that way - but then, on reflection, felt that it wasn\u0027t quite right - filtering is really for restricting items in a collection....and this isn\u0027t a collection of entities.  Also, if we ever wanted to allow writing of config parameters via an API in the future, then this proposed form of API would be much more appropriate, e.g.:\n\nPUT /OS-CONFIG/config/group/token/option\n{\n    expiration : 1000\n}\n\nNote: I am NOT proposing writeable config options via an API in this specific proposal","commit_id":"04a0f304f8fcc805ccbf2c1eb85f16f781fe0adc"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"a5fc30d619f885055aee37da22a0092bc7f0e47c","unresolved":false,"context_lines":[{"line_number":1,"context_line":"OpenStack Identity API v3 OS-REST-CONFIG Extension"},{"line_number":2,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":3,"context_line":""},{"line_number":4,"context_line":"Provide an ability to query the current values of configuration options. This extension"}],"source_content_type":"text/x-markdown","patch_set":2,"id":"baada198_efd2a9fe","line":1,"updated":"2014-07-15 01:00:37.000000000","message":"s/REST-//","commit_id":"3daeebc11ca1030e690032b4b9a447cd759108f1"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"a5fc30d619f885055aee37da22a0092bc7f0e47c","unresolved":false,"context_lines":[{"line_number":7,"context_line":"API Resources"},{"line_number":8,"context_line":"-------------"},{"line_number":9,"context_line":""},{"line_number":10,"context_line":"### Identity Configuration: `/OS-REST_CONFIG/config`"},{"line_number":11,"context_line":""},{"line_number":12,"context_line":"The configuration resource represents the current values of all (or a sub-set)"},{"line_number":13,"context_line":"of the configuration options in the running Identity service."}],"source_content_type":"text/x-markdown","patch_set":2,"id":"baada198_6f069987","line":10,"updated":"2014-07-15 01:00:37.000000000","message":"s/REST_//","commit_id":"3daeebc11ca1030e690032b4b9a447cd759108f1"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"a5fc30d619f885055aee37da22a0092bc7f0e47c","unresolved":false,"context_lines":[{"line_number":37,"context_line":"The following additional APIs are supported by this extension:"},{"line_number":38,"context_line":""},{"line_number":39,"context_line":"#### Get current values of configuration options:"},{"line_number":40,"context_line":"`GET /OS-REST-CONFIG/config`"},{"line_number":41,"context_line":""},{"line_number":42,"context_line":"The actual contents of the response may vary depending on the version of the"},{"line_number":43,"context_line":"identity service being run, but a typical response is shown below:"}],"source_content_type":"text/x-markdown","patch_set":2,"id":"baada198_cfffa564","line":40,"updated":"2014-07-15 01:00:37.000000000","message":"#### Fetch all config groups and options: `GET /OS-CONFIG`","commit_id":"3daeebc11ca1030e690032b4b9a447cd759108f1"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"a5fc30d619f885055aee37da22a0092bc7f0e47c","unresolved":false,"context_lines":[{"line_number":389,"context_line":"        }"},{"line_number":390,"context_line":"    }"},{"line_number":391,"context_line":""},{"line_number":392,"context_line":"Configuration options that are marked as secret will have their values"},{"line_number":393,"context_line":"obfuscated, for example see the ``admin_token`` option in the above example."},{"line_number":394,"context_line":""},{"line_number":395,"context_line":"A specific group or option can also be specified in the url to retrieve a"}],"source_content_type":"text/x-markdown","patch_set":2,"id":"baada198_afe6f1ad","line":392,"updated":"2014-07-15 01:00:37.000000000","message":"For readability, I think this block should go above \"Response:\"","commit_id":"3daeebc11ca1030e690032b4b9a447cd759108f1"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"a5fc30d619f885055aee37da22a0092bc7f0e47c","unresolved":false,"context_lines":[{"line_number":392,"context_line":"Configuration options that are marked as secret will have their values"},{"line_number":393,"context_line":"obfuscated, for example see the ``admin_token`` option in the above example."},{"line_number":394,"context_line":""},{"line_number":395,"context_line":"A specific group or option can also be specified in the url to retrieve a"},{"line_number":396,"context_line":"subset of the configuration options. For example to retrieve the options in"},{"line_number":397,"context_line":"the ``token`` group:"},{"line_number":398,"context_line":""}],"source_content_type":"text/x-markdown","patch_set":2,"id":"baada198_ef03893f","line":395,"updated":"2014-07-15 01:00:37.000000000","message":"This block should go between the sub-header and the response example","commit_id":"3daeebc11ca1030e690032b4b9a447cd759108f1"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"a5fc30d619f885055aee37da22a0092bc7f0e47c","unresolved":false,"context_lines":[{"line_number":396,"context_line":"subset of the configuration options. For example to retrieve the options in"},{"line_number":397,"context_line":"the ``token`` group:"},{"line_number":398,"context_line":""},{"line_number":399,"context_line":"`GET /OS-REST-CONFIG/config/group/token`"},{"line_number":400,"context_line":""},{"line_number":401,"context_line":"Response:"},{"line_number":402,"context_line":""}],"source_content_type":"text/x-markdown","patch_set":2,"id":"baada198_6f62193f","line":399,"updated":"2014-07-15 01:00:37.000000000","message":"#### Fetch specific config group: `GET /OS-CONFIG/group/{group_name}`","commit_id":"3daeebc11ca1030e690032b4b9a447cd759108f1"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"a5fc30d619f885055aee37da22a0092bc7f0e47c","unresolved":false,"context_lines":[{"line_number":416,"context_line":"                \"revocation_cache_time\": 3600,"},{"line_number":417,"context_line":"                \"revoke_by_id\": true"},{"line_number":418,"context_line":"            }"},{"line_number":419,"context_line":"        }"},{"line_number":420,"context_line":"    }"},{"line_number":421,"context_line":""},{"line_number":422,"context_line":"To retrieve just a specific option, then option name itself can be included"}],"source_content_type":"text/x-markdown","patch_set":2,"id":"baada198_2f9101f1","line":419,"updated":"2014-07-15 01:00:37.000000000","message":"missing links section","commit_id":"3daeebc11ca1030e690032b4b9a447cd759108f1"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"a5fc30d619f885055aee37da22a0092bc7f0e47c","unresolved":false,"context_lines":[{"line_number":421,"context_line":""},{"line_number":422,"context_line":"To retrieve just a specific option, then option name itself can be included"},{"line_number":423,"context_line":"in the url. For example, to retrieve the ``expiration`` time from the token"},{"line_number":424,"context_line":"configuration group the following url would be used:"},{"line_number":425,"context_line":""},{"line_number":426,"context_line":""},{"line_number":427,"context_line":"`GET /OS-REST-CONFIG/config/group/token/option/expiration`"}],"source_content_type":"text/x-markdown","patch_set":2,"id":"baada198_0fffdd34","line":424,"updated":"2014-07-15 01:00:37.000000000","message":"This block should go between the sub-header and the response example","commit_id":"3daeebc11ca1030e690032b4b9a447cd759108f1"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"a5fc30d619f885055aee37da22a0092bc7f0e47c","unresolved":false,"context_lines":[{"line_number":424,"context_line":"configuration group the following url would be used:"},{"line_number":425,"context_line":""},{"line_number":426,"context_line":""},{"line_number":427,"context_line":"`GET /OS-REST-CONFIG/config/group/token/option/expiration`"},{"line_number":428,"context_line":""},{"line_number":429,"context_line":"Response:"},{"line_number":430,"context_line":""}],"source_content_type":"text/x-markdown","patch_set":2,"id":"baada198_eff9c980","line":427,"updated":"2014-07-15 01:00:37.000000000","message":"#### Fetch specific option within a specific config group: `GET /OS-CONFIG/config/group/{group_name}/{option}/{option_name}`","commit_id":"3daeebc11ca1030e690032b4b9a447cd759108f1"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"a5fc30d619f885055aee37da22a0092bc7f0e47c","unresolved":false,"context_lines":[{"line_number":435,"context_line":"            \"token\": {"},{"line_number":436,"context_line":"                \"expiration\": 3600"},{"line_number":437,"context_line":"            }"},{"line_number":438,"context_line":"        }"},{"line_number":439,"context_line":"    }"},{"line_number":440,"context_line":""},{"line_number":441,"context_line":"A specific option that is not part of a group can also be retrieved:"}],"source_content_type":"text/x-markdown","patch_set":2,"id":"baada198_8fc12de6","line":438,"updated":"2014-07-15 01:00:37.000000000","message":"missing links section","commit_id":"3daeebc11ca1030e690032b4b9a447cd759108f1"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"a5fc30d619f885055aee37da22a0092bc7f0e47c","unresolved":false,"context_lines":[{"line_number":438,"context_line":"        }"},{"line_number":439,"context_line":"    }"},{"line_number":440,"context_line":""},{"line_number":441,"context_line":"A specific option that is not part of a group can also be retrieved:"},{"line_number":442,"context_line":""},{"line_number":443,"context_line":"`GET /OS-REST-CONFIG/config/option/use_syslog`"},{"line_number":444,"context_line":""}],"source_content_type":"text/x-markdown","patch_set":2,"id":"baada198_cfa08544","line":441,"updated":"2014-07-15 01:00:37.000000000","message":"This block should go between the sub-header and the response example","commit_id":"3daeebc11ca1030e690032b4b9a447cd759108f1"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"a5fc30d619f885055aee37da22a0092bc7f0e47c","unresolved":false,"context_lines":[{"line_number":440,"context_line":""},{"line_number":441,"context_line":"A specific option that is not part of a group can also be retrieved:"},{"line_number":442,"context_line":""},{"line_number":443,"context_line":"`GET /OS-REST-CONFIG/config/option/use_syslog`"},{"line_number":444,"context_line":""},{"line_number":445,"context_line":"Response:"},{"line_number":446,"context_line":""}],"source_content_type":"text/x-markdown","patch_set":2,"id":"baada198_4feb95a3","line":443,"updated":"2014-07-15 01:00:37.000000000","message":"This should align a bit more like the other APIs:\n\n  #### Fetch specific config option not within a group: `GET /OS-CONFIG/config/option/{option_name}`","commit_id":"3daeebc11ca1030e690032b4b9a447cd759108f1"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"a5fc30d619f885055aee37da22a0092bc7f0e47c","unresolved":false,"context_lines":[{"line_number":449,"context_line":"    {"},{"line_number":450,"context_line":"        \"config\": {"},{"line_number":451,"context_line":"            \"use_syslog\": false"},{"line_number":452,"context_line":"        }"},{"line_number":453,"context_line":"    }"}],"source_content_type":"text/x-markdown","patch_set":2,"id":"baada198_6fbe9966","line":452,"updated":"2014-07-15 01:00:37.000000000","message":"missing links section","commit_id":"3daeebc11ca1030e690032b4b9a447cd759108f1"}]}
