README Updates: Clarify Kerberos Configuration

.gitignore

@@ -13,3 +13,4 @@
 .idea/
 *.iml
 *.iws
+*.tgz

README.md

@@ -15,11 +15,11 @@
 
 ## <a name="who"></a>Audience
 
-You are an Apigee Edge API proxy developer, or you would like to learn about developing APIs that run on Apigee Edge. At a minimum, we assume you're familiar with Apigee Edge and how to create simple API proxies. To learn more, we recommend this [getting-started tutorial](http://apigee.com/docs/api-services/tutorials/create-your-first-api). 
+You are an Apigee Edge API proxy developer, or you would like to learn about developing APIs that run on Apigee Edge. At a minimum, we assume you're familiar with Apigee Edge and how to create simple API proxies. To learn more, we recommend this [getting-started tutorial](https://docs.apigee.com/api-platform/tutorials/add-and-configure-your-first-api). 
 
 ## <a name="intro"></a>Intro
 
-This repository contains a collection of sample API proxies that you can deploy and run on [Apigee Edge](http://apigee.com/about/products/api-management). 
+This repository contains a collection of sample API proxies that you can deploy and run on [Apigee Edge](https://apigee.com/api-management/#/products). 
 
 ![alt text](./images/sample-proxies-1.png)
 
@@ -42,7 +42,7 @@ In addition, you'll find:
 
 ## <a name="using"></a>Using the sample proxies
 
-Most developers begin by identifying an interesting sample based on a specific use case or need. You'll find the samples in the `./api-platform-samples/sample-proxies` folder. The Apigee doc site also has a handy [samples overview page](http://apigee.com/docs/api-services/samples/samples-reference). 
+Most developers begin by identifying an interesting sample based on a specific use case or need. You'll find the samples in the `./api-platform-samples/sample-proxies` folder. The Apigee doc site also has a handy [samples overview page](https://docs.apigee.com/api-platform/samples/samples-reference). 
 
 
 For example, if you're interested in doing XML to JSON transformations, check out `api-platform-samples/sample-proxies/xmltojson`. 
@@ -158,7 +158,7 @@ API products, apps, and developers.
 Simple scripts to help you deploy the sample API proxies and profiles that they 
 rely on, including API products, developers, and apps.
 
-Set you Apigee API Platform account settings in `setenv.sh` ([Register for a free Apigee account](http://eneterprise.apigee.com/signup))
+Set you Apigee API Platform account settings in `setenv.sh` ([Register for a free Apigee account](https://docs.apigee.com/api-platform/get-started/creating-apigee-edge-account))
 
 To deploy a single sample, run `deploy.sh proxyName`, where `proxyName` is the name of the directory under `/sample-proxies` that contains the proxy you want to deploy.
 
@@ -178,7 +178,7 @@ To deploy all samples and API products, run `deploy_all.sh`
 
 ## <a name="docs"></a>Apigee Edge documentation
 
-The Apigee Edge docs are [here](http://apigee.com/docs). 
+The Apigee Edge docs are [here](https://docs.apigee.com). 
 
 ---
 

doc-samples/hosted-targets/README.md

@@ -0,0 +1,3 @@
+This directory contains samples that you can deploy on Apigee Edge Hosted Targets. See the README files for detailed instructions.
+
+To learn about Hosted Targets, see [Hosted Targets overview](https://docs.apigee.com/api-platform/hosted-targets/hosted-targets-overview.html) in the Apigee Edge documentation.

doc-samples/hosted-targets/node-hosted-express/README.md

@@ -0,0 +1,102 @@
+# How to create a hello world Node.js application with Hosted Targets using express
+
+This sample is a Node.js proxy that uses [express](https://www.npmjs.com/package/express).
+
+## Test the app locally
+  Before pushing to Apigee, it can be useful to test the application locally first to make sure everything is working as it should.
+
+  1. Make sure you have [Nodejs](https://nodejs.org/en/download/) installed
+  2. Installl dependencies:
+
+      ```
+      cd apiproxy/resources/hosted
+      npm install
+      ```
+
+  3. Start the application:
+
+      ```
+      PORT=8081 node index.js
+      ```
+
+  4. Test the applicaiton:
+
+      ```
+      curl http://localhost:8081
+      {"hello":"Hello World!"}
+
+      curl http://localhost:8081/hello/user
+      {"hello":"hello user"}
+      ```
+
+  5. Remove node_modules and package-lock.json:
+
+      ```
+      rm -rf node_modules
+      rm package-lock.json
+      ```
+
+  6. Go back to the home directory for deploying:
+
+      ```
+      cd ../../..
+      ```
+
+## Deploy the proxy
+  1. Make sure you have [apigeetool](https://github.com/apigee/apigeetool-node) installed
+  2. Make sure you have [get_token](https://apidocs.apigee.com/api-reference/content/using-oauth2-security-apigee-edge-management-api) script installed
+  3. Deploy your proxy:
+
+      ```
+      get_token && apigeetool deployproxy \
+      -o <apigee org> \
+      -e <apigee env> \
+      --json \
+      --token "$(< ~/.sso-cli/valid_token.dat)" \
+      --api node-hosted-express \
+      --directory .
+      ```
+      **Note**: This step might take a minute or two to work
+
+  4. Test your proxy deployment:
+
+      ```
+      curl https:/<apigee org>-<apigee env>.apigee.net/node-hosted-express
+      ```
+
+  5. Undeploy your proxy:
+
+      ```
+      get_token && apigeetool undeploy \
+      -o <apigee org> \
+      -e <apigee env> \
+      --json \
+      --token "$(< ~/.sso-cli/valid_token.dat)" \
+      --api node-hosted-express \
+      --revision <revision to undeploy e.g 1>
+      ```
+
+  For more insight into Hosted Targets and Apigee, visit our [documentation](https://docs.apigee.com/api-platform/hosted-targets/hosted-targets-overview.html).
+
+# Ask the community
+
+[![alt text](../../../images/apigee-community.png "Apigee Community is a great place to ask questions and find answers about developing API proxies. ")](https://community.apigee.com?via=github)
+
+---
+
+Copyright © 2017 Apigee Corporation
+
+Licensed 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.
+
+http://docs.apigee.com/api-services/reference/supported-software
+

doc-samples/hosted-targets/node-hosted-express/apiproxy/node-hosted-express.xml

@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<APIProxy revision="1" name="node-hosted-express">
+    <Basepaths>/node-hosted-express</Basepaths>
+    <ConfigurationVersion majorVersion="4" minorVersion="0"/>
+    <CreatedAt>1512506918706</CreatedAt>
+    <CreatedBy>[email protected]</CreatedBy>
+    <Description></Description>
+    <DisplayName>node-hosted-express</DisplayName>
+    <LastModifiedAt>1512506918706</LastModifiedAt>
+    <LastModifiedBy>[email protected]</LastModifiedBy>
+    <Policies/>
+    <ProxyEndpoints>
+        <ProxyEndpoint>default</ProxyEndpoint>
+    </ProxyEndpoints>
+    <Resources>
+        <Resource>hosted://app.yaml</Resource>
+        <Resource>hosted://index.js</Resource>
+        <Resource>hosted://package.json</Resource>
+    </Resources>
+    <Spec></Spec>
+    <TargetServers/>
+    <TargetEndpoints>
+        <TargetEndpoint>default</TargetEndpoint>
+    </TargetEndpoints>
+</APIProxy>

doc-samples/hosted-targets/node-hosted-express/apiproxy/proxies/default.xml

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<ProxyEndpoint name="default">
+    <Description/>
+    <FaultRules/>
+    <PreFlow name="PreFlow">
+        <Request/>
+        <Response/>
+    </PreFlow>
+    <PostFlow name="PostFlow">
+        <Request/>
+        <Response/>
+    </PostFlow>
+    <Flows/>
+    <HTTPProxyConnection>
+        <BasePath>/node-hosted-express</BasePath>
+        <Properties/>
+        <VirtualHost>default</VirtualHost>
+        <VirtualHost>secure</VirtualHost>
+    </HTTPProxyConnection>
+    <RouteRule name="default">
+        <TargetEndpoint>default</TargetEndpoint>
+    </RouteRule>
+</ProxyEndpoint>

doc-samples/hosted-targets/node-hosted-express/apiproxy/resources/hosted/app.yaml

@@ -0,0 +1,8 @@
+runtime: node
+runtimeVersion: 8
+application: my-express-app
+env:
+  - name: NODE_ENV
+    value: production
+  - name: LOG_LEVEL
+    value: 3

doc-samples/hosted-targets/node-hosted-express/apiproxy/resources/hosted/index.js

@@ -0,0 +1,15 @@
+var express = require('express')
+var app = express()
+
+app.get('/', function (req, res) {
+  res.json({ hello: "Hello World!" })
+})
+
+app.get('/hello/:name', function (req, res) {
+  var name = req.params.name
+  res.json({ hello: "hello " + name })
+})
+
+var server = app.listen(process.env.PORT || 9000, function () {
+    console.log('Listening on port %d', server.address().port)
+})

doc-samples/hosted-targets/node-hosted-express/apiproxy/resources/hosted/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "hello-world",
+  "version": "1.0.0",
+  "main": "index.js",
+  "scripts": {
+    "start": "node index.js --use_strict"
+  },
+  "author": "",
+  "license": "",
+  "dependencies": {
+    "express": "^4.16.0"
+  }
+}

doc-samples/hosted-targets/node-hosted-express/apiproxy/targets/default.xml

@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<TargetEndpoint name="default">
+    <Description/>
+    <FaultRules/>
+    <PreFlow name="PreFlow">
+        <Request/>
+        <Response/>
+    </PreFlow>
+    <PostFlow name="PostFlow">
+        <Request/>
+        <Response/>
+    </PostFlow>
+    <Flows/>
+    <HostedTarget/>
+</TargetEndpoint>

doc-samples/hosted-targets/node-hosted-express/deploy.txt

@@ -0,0 +1,7 @@
+get_token && apigeetool deployproxy \
+      -o apigee-hf-testing \
+      -e test \
+      --json \
+      --token "$(< ~/.sso-cli/valid_token.dat)" \
+      --api node-hosted-express \
+      --directory .

doc-samples/hosted-targets/node-hosted-hello/README.md

@@ -0,0 +1,80 @@
+# How to create a hello world Node.js application with Hosted Targets
+
+This sample is a simple hello world Node.js proxy.
+
+## Test the app locally
+  Before pushing to Apigee, it can be useful to test the application locally first to make sure everything is working as it should.
+
+  1. Make sure you have [Nodejs](https://nodejs.org/en/download/) installed
+
+  2. Start the application:
+
+      ```
+      PORT=8081 node apiproxy/resources/hosted/index.js
+      ```
+
+  3. Test the applicaiton:
+
+      ```
+      curl http://localhost:8081
+      {"date":"2018-03-12T21:45:22.161Z","msg":"Hello, World!"}
+      ```
+
+## Deploy the proxy
+  1. Make sure you have [apigeetool](https://github.com/apigee/apigeetool-node) installed
+  2. Make sure you have [get_token](https://apidocs.apigee.com/api-reference/content/using-oauth2-security-apigee-edge-management-api) script installed
+  3. Deploy your proxy:
+
+      ```
+      get_token && apigeetool deployproxy \
+      -o <apigee org> \
+      -e <apigee env> \
+      --json \
+      --token "$(< ~/.sso-cli/valid_token.dat)" \
+      --api node-hosted-hello \
+      --directory .
+      ```
+      **Note**: This step might take a minute or two to work
+
+  4. Test your proxy deployment:
+
+      ```
+      curl https:/<apigee org>-<apigee env>.apigee.net/node-hosted-hello
+      ```
+
+  5. Undeploy your proxy:
+
+      ```
+      get_token && apigeetool undeploy \
+      -o <apigee org> \
+      -e <apigee env> \
+      --json \
+      --token "$(< ~/.sso-cli/valid_token.dat)" \
+      --api node-hosted-hello \
+      --revision <revision to undeploy e.g 1>
+      ```
+
+  For more insight into Hosted Targets and Apigee, visit our [documentation](https://docs.apigee.com/api-platform/hosted-targets/hosted-targets-overview.html).
+
+# Ask the community
+
+[![alt text](../../../images/apigee-community.png "Apigee Community is a great place to ask questions and find answers about developing API proxies. ")](https://community.apigee.com?via=github)
+
+---
+
+Copyright © 2017 Apigee Corporation
+
+Licensed 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.
+
+http://docs.apigee.com/api-services/reference/supported-software
+

doc-samples/hosted-targets/node-hosted-hello/apiproxy/node-hosted-hello.xml

@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<APIProxy revision="1" name="node-hosted-hello">
+    <Basepaths>/node-hosted-hello</Basepaths>
+    <ConfigurationVersion majorVersion="4" minorVersion="0"/>
+    <CreatedAt>1512506918706</CreatedAt>
+    <CreatedBy>[email protected]</CreatedBy>
+    <Description></Description>
+    <DisplayName>node-hosted-hello</DisplayName>
+    <LastModifiedAt>1512506918706</LastModifiedAt>
+    <LastModifiedBy>[email protected]</LastModifiedBy>
+    <Policies/>
+    <ProxyEndpoints>
+        <ProxyEndpoint>default</ProxyEndpoint>
+    </ProxyEndpoints>
+    <Resources>
+        <Resource>hosted://app.yaml</Resource>
+        <Resource>hosted://index.js</Resource>
+        <Resource>hosted://package.json</Resource>
+    </Resources>
+    <Spec></Spec>
+    <TargetServers/>
+    <TargetEndpoints>
+        <TargetEndpoint>default</TargetEndpoint>
+    </TargetEndpoints>
+</APIProxy>

doc-samples/hosted-targets/node-hosted-hello/apiproxy/proxies/default.xml

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<ProxyEndpoint name="default">
+    <Description/>
+    <FaultRules/>
+    <PreFlow name="PreFlow">
+        <Request/>
+        <Response/>
+    </PreFlow>
+    <PostFlow name="PostFlow">
+        <Request/>
+        <Response/>
+    </PostFlow>
+    <Flows/>
+    <HTTPProxyConnection>
+        <BasePath>/node-hosted-hello</BasePath>
+        <Properties/>
+        <VirtualHost>default</VirtualHost>
+        <VirtualHost>secure</VirtualHost>
+    </HTTPProxyConnection>
+    <RouteRule name="default">
+        <TargetEndpoint>default</TargetEndpoint>
+    </RouteRule>
+</ProxyEndpoint>