[GitHub] geode pull request #583: GEODE-2854: GEODE REST API Docs Missing Authenticat...
Github user asfgit closed the pull request at: https://github.com/apache/geode/pull/583 --- If your project is set up for it, you can reply to this email and have your reply appear on GitHub as well. If your project does not have this feature enabled and wishes so, or if the feature is enabled but not working, please contact infrastructure at infrastruct...@apache.org or file a JIRA ticket with INFRA. ---
[GitHub] geode pull request #583: GEODE-2854: GEODE REST API Docs Missing Authenticat...
Github user karensmolermiller commented on a diff in the pull request: https://github.com/apache/geode/pull/583#discussion_r122326144 --- Diff: geode-docs/rest_apps/setup_config.html.md.erb --- @@ -29,162 +31,233 @@ All Geode REST interface classes and required JAR files are distributed as a WAR where _install-dir_ is the server installation directory and _n.n.n_ is a version number. -To enable the developer REST API service in Apache Geode, set the `start-dev-rest-api` Geode property to `true` when starting a data node using either `gfsh` or the ServerLauncher API. Setting this property to true on a data node will start up an embedded Jetty server and deploy the REST developer API WAR file. +- [Enabling the REST API](#setup_config_enabling_rest) +- [Starting the REST API Service](#setup_config_starting_rest) +- [Implementing Authentication for the REST API](#setup_config_implementing_auth) +- [Programmatic Startup](#setup_config_implementing_auth) + +# Enabling the REST API + +The REST API service for application development runs only on data nodes; you cannot run the service on a locator. + +To enable the Developer REST API service on a given server, set the `start-dev-rest-api` property +to `true` when starting the data node to start an embedded Jetty server and deploy the Developer REST +API WAR file on that node. Use either the `gfsh start server` command or the ServerLauncher API to enable this property. --- End diff -- To help me parse what is getting started and where with the property, can you add a comma or reword the sentence? --- If your project is set up for it, you can reply to this email and have your reply appear on GitHub as well. If your project does not have this feature enabled and wishes so, or if the feature is enabled but not working, please contact infrastructure at infrastruct...@apache.org or file a JIRA ticket with INFRA. ---
[GitHub] geode pull request #583: GEODE-2854: GEODE REST API Docs Missing Authenticat...
Github user joeymcallister commented on a diff in the pull request: https://github.com/apache/geode/pull/583#discussion_r122319962 --- Diff: geode-docs/rest_apps/setup_config.html.md.erb --- @@ -29,162 +31,233 @@ All Geode REST interface classes and required JAR files are distributed as a WAR where _install-dir_ is the server installation directory and _n.n.n_ is a version number. -To enable the developer REST API service in Apache Geode, set the `start-dev-rest-api` Geode property to `true` when starting a data node using either `gfsh` or the ServerLauncher API. Setting this property to true on a data node will start up an embedded Jetty server and deploy the REST developer API WAR file. +- [Enabling the REST API](#setup_config_enabling_rest) +- [Starting the REST API Service](#setup_config_starting_rest) +- [Implementing Authentication for the REST API](#setup_config_implementing_auth) +- [Programmatic Startup](#setup_config_implementing_auth) + +# Enabling the REST API + +The REST API service for application development runs only on data nodes; you cannot run the service on a locator. + +To enable the Developer REST API service on a given server, set the `start-dev-rest-api` property +to `true` when starting the data node to start an embedded Jetty server and deploy the Developer REST +API WAR file on that node. Use either the `gfsh start server` command or the ServerLauncher API to enable this property. -**Note:** -The REST API service for application development runs only on servers; you cannot use locators to host the developer Geode REST API services. +## Enabling the REST API on Multiple Nodes -You can have multiple REST enabled data nodes in a single distributed system. Each data node should +You can configure multiple REST enabled data nodes in a single distributed system. Each data node should have a separate host name and unique end point. To ensure that the data node is reachable on a -machine with multiple NIC addresses, you can use `http-service-bind-address` to bind an address to -the REST API service (as well as the other embedded web services such as Pulse). +machine with multiple NIC addresses, use `http-service-bind-address` to bind an address to +the REST API service (as well as the other embedded web services, such as Pulse). -You can also configure the Developer REST API service to run over -HTTPS by enabling ssl for the `http` component in `gemfire.properties` -or `gfsecurity.properties` or on server startup: -See [SSL](../managing/security/ssl_overview.html) for details on configuring SSL parameters. -These SSL parameters apply to all HTTP services hosted on the configured server, which can include the following: +You can configure the Developer REST API service to run over HTTPS by enabling SSL for the `http` +component in `gemfire.properties` or `gfsecurity.properties`, or on server startup. See +[SSL](../managing/security/ssl_overview.html) for details on configuring SSL parameters. These SSL +parameters apply to all HTTP services hosted on the configured server, which can include the +following: - Developer REST API service - Management REST API service (for remote cluster management) - Pulse monitoring tool -The following procedure starts up a REST API service-enabled Geode deployment: +# Starting the REST API Service -1. Configure PDX for your cluster. You must configure PDX if either or both of the following conditions apply: -- Application peer member caches will access REST-accessible Regions (resources) with the `Region.get(key)`. -- Your deployment has persistent regions that must be available as resources to the REST API. To configure PDX in your cluster, perform the following steps: -1. Start up a locator running the [cluster configuration service](../configuring/cluster_config/gfsh_persist.html) (enabled by default). For example: +To start a REST API service-enabled Geode deployment, configure PDX serialization for your +cluster, then start the service on one or more server nodes. -``` pre -gfsh>start locator --name=locator1 -``` -2. If your deployment has application peer member caches (for example, Java clients) that must also access REST-accessible Regions (resources), use the following gfsh command: +## Configure PDX for your cluster -``` pre -gfsh>configure pdx --read-serialized=true -``` -**Note:** -You do not need to configure `--read-serialized=true` if no application peer member caches are accessing the REST-accessible regions (resources) in your deployment. -3. If your deployment con
[GitHub] geode pull request #583: GEODE-2854: GEODE REST API Docs Missing Authenticat...
Github user joeymcallister commented on a diff in the pull request: https://github.com/apache/geode/pull/583#discussion_r122320206 --- Diff: geode-docs/rest_apps/setup_config.html.md.erb --- @@ -29,162 +31,233 @@ All Geode REST interface classes and required JAR files are distributed as a WAR where _install-dir_ is the server installation directory and _n.n.n_ is a version number. -To enable the developer REST API service in Apache Geode, set the `start-dev-rest-api` Geode property to `true` when starting a data node using either `gfsh` or the ServerLauncher API. Setting this property to true on a data node will start up an embedded Jetty server and deploy the REST developer API WAR file. +- [Enabling the REST API](#setup_config_enabling_rest) +- [Starting the REST API Service](#setup_config_starting_rest) +- [Implementing Authentication for the REST API](#setup_config_implementing_auth) +- [Programmatic Startup](#setup_config_implementing_auth) + +# Enabling the REST API + +The REST API service for application development runs only on data nodes; you cannot run the service on a locator. + +To enable the Developer REST API service on a given server, set the `start-dev-rest-api` property +to `true` when starting the data node to start an embedded Jetty server and deploy the Developer REST +API WAR file on that node. Use either the `gfsh start server` command or the ServerLauncher API to enable this property. -**Note:** -The REST API service for application development runs only on servers; you cannot use locators to host the developer Geode REST API services. +## Enabling the REST API on Multiple Nodes -You can have multiple REST enabled data nodes in a single distributed system. Each data node should +You can configure multiple REST enabled data nodes in a single distributed system. Each data node should have a separate host name and unique end point. To ensure that the data node is reachable on a -machine with multiple NIC addresses, you can use `http-service-bind-address` to bind an address to -the REST API service (as well as the other embedded web services such as Pulse). +machine with multiple NIC addresses, use `http-service-bind-address` to bind an address to +the REST API service (as well as the other embedded web services, such as Pulse). -You can also configure the Developer REST API service to run over -HTTPS by enabling ssl for the `http` component in `gemfire.properties` -or `gfsecurity.properties` or on server startup: -See [SSL](../managing/security/ssl_overview.html) for details on configuring SSL parameters. -These SSL parameters apply to all HTTP services hosted on the configured server, which can include the following: +You can configure the Developer REST API service to run over HTTPS by enabling SSL for the `http` +component in `gemfire.properties` or `gfsecurity.properties`, or on server startup. See +[SSL](../managing/security/ssl_overview.html) for details on configuring SSL parameters. These SSL +parameters apply to all HTTP services hosted on the configured server, which can include the +following: - Developer REST API service - Management REST API service (for remote cluster management) - Pulse monitoring tool -The following procedure starts up a REST API service-enabled Geode deployment: +# Starting the REST API Service -1. Configure PDX for your cluster. You must configure PDX if either or both of the following conditions apply: -- Application peer member caches will access REST-accessible Regions (resources) with the `Region.get(key)`. -- Your deployment has persistent regions that must be available as resources to the REST API. To configure PDX in your cluster, perform the following steps: -1. Start up a locator running the [cluster configuration service](../configuring/cluster_config/gfsh_persist.html) (enabled by default). For example: +To start a REST API service-enabled Geode deployment, configure PDX serialization for your +cluster, then start the service on one or more server nodes. -``` pre -gfsh>start locator --name=locator1 -``` -2. If your deployment has application peer member caches (for example, Java clients) that must also access REST-accessible Regions (resources), use the following gfsh command: +## Configure PDX for your cluster -``` pre -gfsh>configure pdx --read-serialized=true -``` -**Note:** -You do not need to configure `--read-serialized=true` if no application peer member caches are accessing the REST-accessible regions (resources) in your deployment. -3. If your deployment con
[GitHub] geode pull request #583: GEODE-2854: GEODE REST API Docs Missing Authenticat...
Github user joeymcallister commented on a diff in the pull request: https://github.com/apache/geode/pull/583#discussion_r122320074 --- Diff: geode-docs/rest_apps/setup_config.html.md.erb --- @@ -29,162 +31,233 @@ All Geode REST interface classes and required JAR files are distributed as a WAR where _install-dir_ is the server installation directory and _n.n.n_ is a version number. -To enable the developer REST API service in Apache Geode, set the `start-dev-rest-api` Geode property to `true` when starting a data node using either `gfsh` or the ServerLauncher API. Setting this property to true on a data node will start up an embedded Jetty server and deploy the REST developer API WAR file. +- [Enabling the REST API](#setup_config_enabling_rest) +- [Starting the REST API Service](#setup_config_starting_rest) +- [Implementing Authentication for the REST API](#setup_config_implementing_auth) +- [Programmatic Startup](#setup_config_implementing_auth) + +# Enabling the REST API + +The REST API service for application development runs only on data nodes; you cannot run the service on a locator. + +To enable the Developer REST API service on a given server, set the `start-dev-rest-api` property +to `true` when starting the data node to start an embedded Jetty server and deploy the Developer REST +API WAR file on that node. Use either the `gfsh start server` command or the ServerLauncher API to enable this property. -**Note:** -The REST API service for application development runs only on servers; you cannot use locators to host the developer Geode REST API services. +## Enabling the REST API on Multiple Nodes -You can have multiple REST enabled data nodes in a single distributed system. Each data node should +You can configure multiple REST enabled data nodes in a single distributed system. Each data node should have a separate host name and unique end point. To ensure that the data node is reachable on a -machine with multiple NIC addresses, you can use `http-service-bind-address` to bind an address to -the REST API service (as well as the other embedded web services such as Pulse). +machine with multiple NIC addresses, use `http-service-bind-address` to bind an address to +the REST API service (as well as the other embedded web services, such as Pulse). -You can also configure the Developer REST API service to run over -HTTPS by enabling ssl for the `http` component in `gemfire.properties` -or `gfsecurity.properties` or on server startup: -See [SSL](../managing/security/ssl_overview.html) for details on configuring SSL parameters. -These SSL parameters apply to all HTTP services hosted on the configured server, which can include the following: +You can configure the Developer REST API service to run over HTTPS by enabling SSL for the `http` +component in `gemfire.properties` or `gfsecurity.properties`, or on server startup. See +[SSL](../managing/security/ssl_overview.html) for details on configuring SSL parameters. These SSL +parameters apply to all HTTP services hosted on the configured server, which can include the +following: - Developer REST API service - Management REST API service (for remote cluster management) - Pulse monitoring tool -The following procedure starts up a REST API service-enabled Geode deployment: +# Starting the REST API Service -1. Configure PDX for your cluster. You must configure PDX if either or both of the following conditions apply: -- Application peer member caches will access REST-accessible Regions (resources) with the `Region.get(key)`. -- Your deployment has persistent regions that must be available as resources to the REST API. To configure PDX in your cluster, perform the following steps: -1. Start up a locator running the [cluster configuration service](../configuring/cluster_config/gfsh_persist.html) (enabled by default). For example: +To start a REST API service-enabled Geode deployment, configure PDX serialization for your +cluster, then start the service on one or more server nodes. -``` pre -gfsh>start locator --name=locator1 -``` -2. If your deployment has application peer member caches (for example, Java clients) that must also access REST-accessible Regions (resources), use the following gfsh command: +## Configure PDX for your cluster -``` pre -gfsh>configure pdx --read-serialized=true -``` -**Note:** -You do not need to configure `--read-serialized=true` if no application peer member caches are accessing the REST-accessible regions (resources) in your deployment. -3. If your deployment con
[GitHub] geode pull request #583: GEODE-2854: GEODE REST API Docs Missing Authenticat...
GitHub user davebarnes97 opened a pull request: https://github.com/apache/geode/pull/583 GEODE-2854: GEODE REST API Docs Missing Authentication Reviews requested from: @mmartell, @jaredjstewart @karensmolermiller @joeymcallister You can merge this pull request into a Git repository by running: $ git pull https://github.com/davebarnes97/geode feature/GEODE-2854 Alternatively you can review and apply these changes as the patch at: https://github.com/apache/geode/pull/583.patch To close this pull request, make a commit to your master/trunk branch with (at least) the following in the commit message: This closes #583 commit a77860db914498585fb4bd90f27f3cd488e9 Author: Dave Barnes Date: 2017-06-15T20:43:41Z GEODE-2854: GEODE REST API Docs Missing Authentication --- If your project is set up for it, you can reply to this email and have your reply appear on GitHub as well. If your project does not have this feature enabled and wishes so, or if the feature is enabled but not working, please contact infrastructure at infrastruct...@apache.org or file a JIRA ticket with INFRA. ---