├── app
    ├── js
    │   ├── config.sample.js
    │   └── app.js
    ├── css
    │   ├── app.css
    │   ├── normalize.css
    │   └── skeleton.css
    └── index.html
├── server
    ├── package.json
    ├── api
    │   └── index.js
    ├── swagger.sample.yaml
    └── app-sam.sample.yaml
├── .gitignore
├── README.md
└── LICENSE


/app/js/config.sample.js:
--------------------------------------------------------------------------------
1 | ///
2 | /// Update with the endpoint to your API Gateway
3 | ///
4 | 
5 | const SignedUrlEndpoint = 'https://<API_DOMAIN>.execute-api.<REGION>.amazonaws.com/prod'


--------------------------------------------------------------------------------
/app/css/app.css:
--------------------------------------------------------------------------------
 1 | @import url('https://fonts.googleapis.com/css?family=Raleway:400,300,600');
 2 | 
 3 | body {
 4 |   font-family: "Raleway", "Arial", sans-serif;
 5 |   padding-top: 50px;
 6 | }
 7 | 
 8 | #console {
 9 | 	height: 200px;
10 | }


--------------------------------------------------------------------------------
/server/package.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "name": "aws-presigned-url-upload",
 3 |   "version": "1.0.0",
 4 |   "description": "Sample front and backend for uploading files to Amazon S3 via pre-signed URL",
 5 |   "main": "index.js",
 6 |   "repository": {
 7 |     "type": "git",
 8 |     "url": "git+https://github.com/jkahn117/aws-presigned-url-upload.git"
 9 |   },
10 |   "author": "jkahn117",
11 |   "license": "Apache-2.0",
12 |   "bugs": {
13 |     "url": "https://github.com/jkahn117/aws-presigned-url-upload/issues"
14 |   },
15 |   "homepage": "https://github.com/jkahn117/aws-presigned-url-upload#readme"
16 | }
17 | 


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
 1 | # Logs
 2 | logs
 3 | *.log
 4 | npm-debug.log*
 5 | 
 6 | # Runtime data
 7 | pids
 8 | *.pid
 9 | *.seed
10 | 
11 | # Directory for instrumented libs generated by jscoverage/JSCover
12 | lib-cov
13 | 
14 | # Coverage directory used by tools like istanbul
15 | coverage
16 | 
17 | # nyc test coverage
18 | .nyc_output
19 | 
20 | # Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
21 | .grunt
22 | 
23 | # node-waf configuration
24 | .lock-wscript
25 | 
26 | # Compiled binary addons (http://nodejs.org/api/addons.html)
27 | build/Release
28 | 
29 | # Dependency directories
30 | node_modules
31 | jspm_packages
32 | 
33 | # Optional npm cache directory
34 | .npm
35 | 
36 | # Optional REPL history
37 | .node_repl_history
38 | 
39 | # custom
40 | deploy.sh
41 | server/app-sam.yaml
42 | server/app-sam-output.yaml
43 | swagger.yaml
44 | app/js/config.js
45 | 


--------------------------------------------------------------------------------
/server/api/index.js:
--------------------------------------------------------------------------------
 1 | /**
 2 |  * Returns a signed url to allow a 'PutObject' operation on the S3
 3 |  * Bucket designated via Environment Variable.
 4 |  */
 5 | 
 6 | const AWS = require('aws-sdk')
 7 | 
 8 | const buildResponse = (statusCode, body) => {
 9 |   return {
10 |     statusCode: statusCode,
11 |     body: JSON.stringify(body),
12 |     headers: {
13 |       'Content-Type': 'application/json',
14 |       // In aws_proxy mode, Lambda function must return its own access control
15 |       // header to enable CORS.
16 |       'Access-Control-Allow-Origin': '*'
17 |     }
18 |   };
19 | };
20 | 
21 | exports.handler = (event, context, callback) => {
22 |   let fileData = event.queryStringParameters
23 | 
24 |   let params = {
25 |     Bucket: process.env.UPLOAD_BUCKET,
26 |     Key: decodeURIComponent(fileData.name),
27 |     ContentType: decodeURIComponent(fileData.type),
28 |     ACL: 'public-read'
29 |     // ServerSideEncryption: 'AES256' // <-- uncomment to add server-side encryption
30 |   }
31 | 
32 |   let s3 = new AWS.S3()
33 |   s3.getSignedUrl('putObject', params, (error, data) => {
34 |     if (error) {
35 |       console.error(error)
36 |       callback(error, null)
37 |     } else {
38 |       callback(null, buildResponse( 200, { "url": data } ))
39 |     }
40 |   })
41 | }
42 | 


--------------------------------------------------------------------------------
/server/swagger.sample.yaml:
--------------------------------------------------------------------------------
 1 | swagger: 2.0
 2 | info:
 3 |   title: 'presigned-url-api'
 4 | paths:
 5 |   '/signedurl':
 6 |     get:
 7 |       consumes:
 8 |         - application/json
 9 |       produces:
10 |         - application/json
11 |       x-amazon-apigateway-integration:
12 |         httpMethod: POST
13 |         type: aws_proxy
14 |         uri: arn:aws:apigateway:<<REGION>>:lambda:path/2015-03-31/functions/arn:aws:lambda:<<REGION>>:<<ACCOUNT_NUMBER>>:function:${stageVariables.SignedUrlFunction}/invocations
15 |         responses: {}
16 |     options:
17 |       consumes:
18 |         - application/json
19 |       produces:
20 |         - application/json
21 |       responses:
22 |         200:
23 |           description: 200 response
24 |           headers:
25 |             Access-Control-Allow-Origin:
26 |               type: string
27 |             Access-Control-Allow-Methods:
28 |               type: string
29 |             Access-Control-Allow-Headers:
30 |               type: string
31 |       x-amazon-apigateway-integration:
32 |         type: mock
33 |         passthroughBehavior: when_no_match
34 |         requestTemplates:
35 |           application/json: '{ "statusCode": 200 }'
36 |         responses:
37 |           default:
38 |             statusCode: 200
39 |             responseParameters:
40 |               method.response.header.Access-Control-Allow-Methods: "'GET,HEAD,OPTIONS'"
41 |               method.response.header.Access-Control-Allow-Headers: "'Content-Type,Authorization,X-Amz-Date,X-Api-Key,X-Amz-Security-Token'"
42 |               method.response.header.Access-Control-Allow-Origin: "'*'"
43 | 


--------------------------------------------------------------------------------
/app/js/app.js:
--------------------------------------------------------------------------------
 1 | function appendToConsole(message) {
 2 |   $('#console').append(message + '\n')
 3 | }
 4 | 
 5 | function getSignedUrlPromise(fileName, fileType) {
 6 |   appendToConsole('Fetching signed URL')
 7 |   var url = `${SignedUrlEndpoint}/signedurl?name=${fileName}&type=${fileType}`
 8 | 
 9 |   return new Promise( (resolve, reject) => {
10 |     $.getJSON(url)
11 |       .done((data) => {
12 |         appendToConsole('Received signed url:\n' + data.url)
13 |         resolve(data.url)
14 |       })
15 |       .fail((error) => {
16 |         console.error(error)
17 |         reject(error.statusText)
18 |       })
19 |   })
20 | }
21 | 
22 | function uploadFilePromise(url, file) {
23 |   appendToConsole(`Uploading file (${file.size} bytes)`)
24 |   
25 |   return new Promise( (resolve, reject) => {
26 |     $.ajax({
27 |       url: url,
28 |       type: 'PUT',
29 |       data: file,
30 |       processData: false,
31 |       contentType: file.type
32 |     })
33 |     .done(() => resolve())
34 |     .fail((error) => {
35 |       console.error(error)
36 |       reject(error.statusText)
37 |     })
38 |   })
39 | }
40 | 
41 | $('#myForm').on('submit', function(e) {
42 |   e.preventDefault()
43 |   $('#uploadButton').prop('disabled', true)
44 | 
45 |   var file = $(this).find('input:file').prop('files')[0]
46 |   if (file) {
47 |     getSignedUrlPromise(file.name, file.type)
48 |       .then((url) => uploadFilePromise(url, file))
49 |       .then(() => appendToConsole('Upload complete!'))
50 |       .catch((error) => appendToConsole('ERROR: ' + error))
51 |   } else {
52 |     appendToConsole('No file selected')
53 |   }
54 | })
55 | 


--------------------------------------------------------------------------------
/server/app-sam.sample.yaml:
--------------------------------------------------------------------------------
 1 | ---
 2 | 
 3 | AWSTemplateFormatVersion: "2010-09-09"
 4 | Transform: "AWS::Serverless-2016-10-31"
 5 | 
 6 | Description: "Backend API for uploaded files to Amazon S3 via Pre-Signed URL"
 7 | 
 8 | Resources:
 9 |   ImageUploadBucket:
10 |     Type: AWS::S3::Bucket
11 |     Properties:
12 |       BucketName: <BUCKET_NAME>
13 |       CorsConfiguration:
14 |         CorsRules:
15 |           - 
16 |             AllowedMethods: [ PUT ]
17 |             AllowedOrigins: [ '*' ]
18 |             AllowedHeaders: [ '*' ]
19 | 
20 |   SignedUrlFunction:
21 |     Type: AWS::Serverless::Function
22 |     Properties:
23 |       CodeUri: api/
24 |       Handler: index.handler
25 |       Runtime: nodejs6.10
26 |       Role: !GetAtt SignedUrlFunctionRole.Arn
27 |       Environment:
28 |         Variables:
29 |           UPLOAD_BUCKET: !Ref ImageUploadBucket
30 |       Events:
31 |         GetUrl:
32 |           Type: Api
33 |           Properties:
34 |             RestApiId: !Ref SignedUrlApi
35 |             Path: /signedurl
36 |             Method: GET
37 | 
38 |   SignedUrlFunctionRole:
39 |     Type: AWS::IAM::Role
40 |     Properties:
41 |       Path: "/"
42 |       ManagedPolicyArns:
43 |         - arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole
44 |       AssumeRolePolicyDocument:
45 |         Version: "2012-10-17"
46 |         Statement:
47 |           -
48 |             Sid: AllowLambdaServiceToAssumeRole
49 |             Effect: Allow
50 |             Action: 
51 |               - sts:AssumeRole
52 |             Principal:
53 |               Service: 
54 |                 - lambda.amazonaws.com
55 | 
56 |   SignedUrlFunctionPolicy:
57 |     Type: AWS::IAM::Policy
58 |     DependsOn: SignedUrlFunctionRole
59 |     Properties:
60 |       PolicyName: LambdaPetStoreSignedUrlFunctionPolicy
61 |       Roles:
62 |         - !Ref SignedUrlFunctionRole
63 |       PolicyDocument:
64 |         Version: "2012-10-17"
65 |         Statement: 
66 |           -
67 |             Effect:   "Allow"
68 |             Resource:
69 |               - !Sub arn:aws:s3:::${ImageUploadBucket}/*
70 |             Action:
71 |               - "s3:Put*"
72 | 
73 |   SignedUrlApi:
74 |     Type: AWS::Serverless::Api
75 |     Properties:
76 |       StageName: prod
77 |       DefinitionUri: swagger.yaml
78 |       Variables:
79 |         SignedUrlFunction: !Ref SignedUrlFunction
80 | 
81 | Outputs:
82 |   ApiDomain:
83 |     Description: Domain of your API
84 |     Value: !Ref SignedUrlApi
85 |   ApiUrl:
86 |     Description: URL of your API
87 |     Value: !Sub
88 |       - http://${ApiDomain}.execute-api.${AWS::Region}.amazonaws.com/prod
89 |       - { ApiDomain: !Ref SignedUrlApi }
90 | 


--------------------------------------------------------------------------------
/app/index.html:
--------------------------------------------------------------------------------
 1 | <!DOCTYPE html>
 2 | <html lang="en">
 3 | <head>
 4 |   <meta charset="utf-8">
 5 |   <title>Uploading Files to Amazon S3 using Pre-Signed URLs</title>
 6 |   <meta name="author" content="">
 7 |   <meta name="viewport" content="width=device-width, initial-scale=1">
 8 | 
 9 |   <link rel="stylesheet" href="css/normalize.css">
10 |   <link rel="stylesheet" href="css/skeleton.css">
11 |   <link rel="stylesheet" href="css/app.css">
12 | </head>
13 | 
14 | 
15 | <body>
16 | 	<div class="container">
17 | 		<h1>Uploading Files to Amazon S3 using Pre-Signed URLs</h1>
18 | 		<p>
19 | 			This project is a sample approach to uploading files to Amazon S3 using <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/PresignedUrlUploadObject.html">Pre-Signed URLs</a>.  While this projects makes use of Node.js, any other backend platform with an availble AWS SDK can be supported.
20 | 		</p>
21 | 		<p>
22 | 			For more details and source code, see: <a href="https://github.com/jkahn117/aws-presigned-url-upload">https://github.com/jkahn117/aws-presigned-url-upload</a>.
23 | 		</p>
24 | 
25 | 		<hr/>
26 | 
27 | 		<div class="row">
28 | 			<div class="one-half column">
29 | 				<h3>Example</h3>
30 | 				<form enctype="multipart/form-data" novalidate id="myForm">
31 | 					<div class="row">
32 | 						<label for="myFileInput">My File</label>
33 | 						<input class="u-full-width" type="file" accept="image/*" id="myFileInput"/>
34 | 					</div>
35 | 
36 | 					<div class="row">
37 | 						<input class="button-primary" id="uploadButton" type="submit" value="Upload">
38 | 					</div>
39 | 				</form>
40 | 			</div>
41 | 
42 | 			<div class="one-half column">
43 | 				<h3>Console</h3>
44 | 				<div class="row">
45 | 					<pre><code id="console"></code></pre>
46 | 				</div>
47 | 			</div>
48 | 		</div>
49 | 
50 | 		<hr/>
51 | 
52 | 		<div class="row">
53 | 			<div class="one-half column">
54 | 				<h3>Client</h3>
55 | 				<div class="row">
56 | 					<pre><code>// using jQuery
57 | $.ajax({
58 |   url: url,
59 |   type: 'PUT',
60 |   data: file,
61 |   processData: false,
62 |   contentType: file.type
63 | })</code></pre>
64 | 				</div>
65 | 			</div>
66 | 
67 | 			<div class="one-half column">
68 | 				<h3>Server (Node.js)</h3>
69 | 				<div class="row">
70 | 					<pre><code>let params = {
71 |   Bucket: &lt;UPLOAD_BUCKET&gt;,
72 |   Key: fileName,
73 |   ContentType: fileType,
74 |   ACL: 'public-read'
75 |   // ServerSideEncryption: 'AES256' // <-- uncomment to add server-side encryption
76 | }
77 | 
78 | let s3 = new AWS.S3()
79 | s3.getSignedUrl('putObject', params, (error, data) => {
80 |   if (error) {
81 |     // handle error
82 |   } else {
83 |     // handle success
84 |   }
85 | })</code></pre>
86 | 				</div>
87 | 			</div>
88 | 		</div>
89 | 
90 | 	</div>
91 | 
92 | 	<script src="https://code.jquery.com/jquery-3.2.1.min.js"></script>
93 | 	<script src="js/config.js"></script>
94 | 	<script src="js/app.js"></script>
95 | 
96 | </body>
97 | </html>


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | # aws-presigned-url-upload
  2 | 
  3 | This project is an example of how to leverage Amazon S3 Presigned URLs to securely upload objects from a web client to an S3 Bucket.  This approach is useful when you want to allow your end users to upload a file, but do not want to require them to have AWS credentials or permissions.
  4 | 
  5 | You may also note that it is possible to upload a file (`PutObject`) to an S3 Bucket using the AWS SDK (for [example](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#putObject-property)).  Not only does this approach require AWS Credentials, but also inclusion of the AWS SDK in your client project, which is unnecessary to only upload a file.
  6 | 
  7 | ## Getting Started
  8 | 
  9 | To get started, clone this repository locally:
 10 | 
 11 | ```
 12 | $ git clone https://github.com/jkahn117/aws-presigned-url-upload
 13 | ```
 14 | 
 15 | The repository contains a [CloudFormation](https://aws.amazon.com/cloudformation/) template and source code to deploy and run a complete sample application.
 16 | 
 17 | ### Prerequisites
 18 | 
 19 | To run the aws-presigned-url-upload sample, you will need to:
 20 | 
 21 | 1. Select an AWS Region into which you will deploy services. Be sure that all required services (AWS Lambda and Amazon API Gateway) are available in the Region you select.
 22 | 2. Confirm your [installation of the latest AWS CLI](http://docs.aws.amazon.com/cli/latest/userguide/installing.html) (at least version 1.11.21).
 23 | 3. Confirm the [AWS CLI is properly configured](http://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html#cli-quick-configuration) with credentials that have administrator access to your AWS account.
 24 | 4. [Install Node.js and NPM](https://docs.npmjs.com/getting-started/installing-node).
 25 | 
 26 | ## Setting Up the Environment
 27 | 
 28 | Before deploying the sample, install several dependencies using NPM:
 29 | 
 30 | ```
 31 | $ cd server
 32 | $ npm install
 33 | ```
 34 | 
 35 | ## Deploy AWS Resources
 36 | 
 37 | The deployment of our AWS resources is managed by the [Serverless Application Model](https://github.com/awslabs/serverless-application-model), which is an extension of CloudFormation.
 38 | 
 39 | 1. Rename `server/app-sam.sample.yaml` to `server/app-sam.yaml` and replace the value `<BUCKET_NAME>` with a name of your choosing.  This will be the S3 Bucket into which files are uploaded (remember S3 Bucket names are globally unique).
 40 | 
 41 | 2. Rename `server/swagger.sample.yaml` to `server/swagger.yaml` and replace the value `<REGION>` with the AWS Region selected (e.g. us-east-1) and the value `<ACCOUNT_NUMBER>` with your [AWS account number](https://docs.aws.amazon.com/general/latest/gr/acct-identifiers.html).
 42 | 
 43 | 3. If you would like your uploaded file to leverage server-side encryption, you can uncomment line 29 in the file `server/api/index.js`.
 44 | 
 45 | 4. Create a new S3 bucket from which to deploy our source code (ensure that the bucket is created in the same AWS Region as your network and services will be deployed):
 46 | 
 47 |     ```
 48 |     $ aws s3 mb s3://<MY_BUCKET_NAME>
 49 |     ```
 50 | 5. Using the SAM, package your source code and serverless stack:
 51 | 
 52 |     ```
 53 |     $ aws cloudformation package --template-file app-sam.yaml --s3-bucket <MY_BUCKET_NAME> --output-template-file app-sam-output.yaml
 54 |     ```
 55 | 6. Once packaging is complete, deploy the stack (note: this step may require 10-15 minutes as ElastiCache is deployed):
 56 | 
 57 |     ```
 58 |     $ aws cloudformation deploy --template-file app-sam-output.yaml --stack-name aws-presigned-url-upload --capabilities CAPABILITY_IAM
 59 |     ```
 60 | 7. After your stack has been created, the sample API has been deployed and you can retrieve the domain of the API (going forward, we will refer to it as API_DOMAIN):
 61 | 
 62 |     ```
 63 |     $ aws cloudformation describe-stacks --stack-name aws-presigned-url-upload --query 'Stacks[0].Outputs[?OutputKey==`ApiDomain`].OutputValue'
 64 |     ```
 65 | 
 66 | ## Configure Web Client
 67 | 
 68 | With our backend ready, we will make a quick change to the frontend to reference our newly deployed API:
 69 | 
 70 | 1. Rename `app/js/config.sample.js` to `app/js/config.js` and open the file.  Replace `<API_DOMAIN>` with the value found above and `<REGION>` with your deployment region (e.g. us-east-1).
 71 | 
 72 | 2. Save the file.
 73 | 
 74 | ## Test
 75 | 
 76 | Open the sample frontend by double-clicking on `app/index.html`.  This page provides an overview of this sample as well as simple implementation.
 77 | 
 78 | Click the 'Choose File' button and pick an image file from your desktop.  Then click 'Upload'.
 79 | 
 80 | On the right, the Console section will log information as the sample runs.  The general flow is as follows:
 81 | 
 82 | 1. Grab file metadata, specifically name and type.
 83 | 2. `GET` pre-signed URL from API, passing the file name and type as query string parameters.
 84 | 3. Use `PUT` request to put the object in the S3 Bucket.
 85 | 4. Confirm the file has been uploaded by visiting the S3 Console.
 86 | 
 87 | ## Cleaning Up
 88 | 
 89 | Finally, we will clean up the AWS environment using CloudFormation:
 90 | 
 91 | ```
 92 | $ aws cloudformation delete-stack --stack-name aws-presigned-url-upload
 93 | ```
 94 | 
 95 | ## Additional Notes
 96 | 
 97 | Now that you have seen our sample live, a few notes on the implementation:
 98 | 
 99 | * At least for the purposes of this demo, [CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/Access_control_CORS) is required for both the backend API and S3 Bucket.  The CORS configuration / headers are setup for you in the demo, but this can often be a source of trouble (unless all resources are hosted on a single domain).
100 | 
101 | * Our Lambda function to create the pre-signed URL must have a role with permission to put an object (`PutObject`) in our upload bucket.  Again, this is configured for you (see `app-sam.yaml`, specifically `SignedUrlFunctionPolicy`), but without this permission, the end user will not be able to upload to the bucket.
102 | 
103 | * Our sample makes use of jQuery to interact with the API and S3.  While numerous other options exist for these interactions, we found using jQuery's `$.ajax` method most effective to put the image object in the S3 Bucket.  Other approaches utilized `multipart/form-data` which tended to cause problems.
104 | 
105 | 


--------------------------------------------------------------------------------
/app/css/normalize.css:
--------------------------------------------------------------------------------
  1 | /*! normalize.css v3.0.2 | MIT License | git.io/normalize */
  2 | 
  3 | /**
  4 |  * 1. Set default font family to sans-serif.
  5 |  * 2. Prevent iOS text size adjust after orientation change, without disabling
  6 |  *    user zoom.
  7 |  */
  8 | 
  9 | html {
 10 |   font-family: sans-serif; /* 1 */
 11 |   -ms-text-size-adjust: 100%; /* 2 */
 12 |   -webkit-text-size-adjust: 100%; /* 2 */
 13 | }
 14 | 
 15 | /**
 16 |  * Remove default margin.
 17 |  */
 18 | 
 19 | body {
 20 |   margin: 0;
 21 | }
 22 | 
 23 | /* HTML5 display definitions
 24 |    ========================================================================== */
 25 | 
 26 | /**
 27 |  * Correct `block` display not defined for any HTML5 element in IE 8/9.
 28 |  * Correct `block` display not defined for `details` or `summary` in IE 10/11
 29 |  * and Firefox.
 30 |  * Correct `block` display not defined for `main` in IE 11.
 31 |  */
 32 | 
 33 | article,
 34 | aside,
 35 | details,
 36 | figcaption,
 37 | figure,
 38 | footer,
 39 | header,
 40 | hgroup,
 41 | main,
 42 | menu,
 43 | nav,
 44 | section,
 45 | summary {
 46 |   display: block;
 47 | }
 48 | 
 49 | /**
 50 |  * 1. Correct `inline-block` display not defined in IE 8/9.
 51 |  * 2. Normalize vertical alignment of `progress` in Chrome, Firefox, and Opera.
 52 |  */
 53 | 
 54 | audio,
 55 | canvas,
 56 | progress,
 57 | video {
 58 |   display: inline-block; /* 1 */
 59 |   vertical-align: baseline; /* 2 */
 60 | }
 61 | 
 62 | /**
 63 |  * Prevent modern browsers from displaying `audio` without controls.
 64 |  * Remove excess height in iOS 5 devices.
 65 |  */
 66 | 
 67 | audio:not([controls]) {
 68 |   display: none;
 69 |   height: 0;
 70 | }
 71 | 
 72 | /**
 73 |  * Address `[hidden]` styling not present in IE 8/9/10.
 74 |  * Hide the `template` element in IE 8/9/11, Safari, and Firefox < 22.
 75 |  */
 76 | 
 77 | [hidden],
 78 | template {
 79 |   display: none;
 80 | }
 81 | 
 82 | /* Links
 83 |    ========================================================================== */
 84 | 
 85 | /**
 86 |  * Remove the gray background color from active links in IE 10.
 87 |  */
 88 | 
 89 | a {
 90 |   background-color: transparent;
 91 | }
 92 | 
 93 | /**
 94 |  * Improve readability when focused and also mouse hovered in all browsers.
 95 |  */
 96 | 
 97 | a:active,
 98 | a:hover {
 99 |   outline: 0;
100 | }
101 | 
102 | /* Text-level semantics
103 |    ========================================================================== */
104 | 
105 | /**
106 |  * Address styling not present in IE 8/9/10/11, Safari, and Chrome.
107 |  */
108 | 
109 | abbr[title] {
110 |   border-bottom: 1px dotted;
111 | }
112 | 
113 | /**
114 |  * Address style set to `bolder` in Firefox 4+, Safari, and Chrome.
115 |  */
116 | 
117 | b,
118 | strong {
119 |   font-weight: bold;
120 | }
121 | 
122 | /**
123 |  * Address styling not present in Safari and Chrome.
124 |  */
125 | 
126 | dfn {
127 |   font-style: italic;
128 | }
129 | 
130 | /**
131 |  * Address variable `h1` font-size and margin within `section` and `article`
132 |  * contexts in Firefox 4+, Safari, and Chrome.
133 |  */
134 | 
135 | h1 {
136 |   font-size: 2em;
137 |   margin: 0.67em 0;
138 | }
139 | 
140 | /**
141 |  * Address styling not present in IE 8/9.
142 |  */
143 | 
144 | mark {
145 |   background: #ff0;
146 |   color: #000;
147 | }
148 | 
149 | /**
150 |  * Address inconsistent and variable font size in all browsers.
151 |  */
152 | 
153 | small {
154 |   font-size: 80%;
155 | }
156 | 
157 | /**
158 |  * Prevent `sub` and `sup` affecting `line-height` in all browsers.
159 |  */
160 | 
161 | sub,
162 | sup {
163 |   font-size: 75%;
164 |   line-height: 0;
165 |   position: relative;
166 |   vertical-align: baseline;
167 | }
168 | 
169 | sup {
170 |   top: -0.5em;
171 | }
172 | 
173 | sub {
174 |   bottom: -0.25em;
175 | }
176 | 
177 | /* Embedded content
178 |    ========================================================================== */
179 | 
180 | /**
181 |  * Remove border when inside `a` element in IE 8/9/10.
182 |  */
183 | 
184 | img {
185 |   border: 0;
186 | }
187 | 
188 | /**
189 |  * Correct overflow not hidden in IE 9/10/11.
190 |  */
191 | 
192 | svg:not(:root) {
193 |   overflow: hidden;
194 | }
195 | 
196 | /* Grouping content
197 |    ========================================================================== */
198 | 
199 | /**
200 |  * Address margin not present in IE 8/9 and Safari.
201 |  */
202 | 
203 | figure {
204 |   margin: 1em 40px;
205 | }
206 | 
207 | /**
208 |  * Address differences between Firefox and other browsers.
209 |  */
210 | 
211 | hr {
212 |   -moz-box-sizing: content-box;
213 |   box-sizing: content-box;
214 |   height: 0;
215 | }
216 | 
217 | /**
218 |  * Contain overflow in all browsers.
219 |  */
220 | 
221 | pre {
222 |   overflow: auto;
223 | }
224 | 
225 | /**
226 |  * Address odd `em`-unit font size rendering in all browsers.
227 |  */
228 | 
229 | code,
230 | kbd,
231 | pre,
232 | samp {
233 |   font-family: monospace, monospace;
234 |   font-size: 1em;
235 | }
236 | 
237 | /* Forms
238 |    ========================================================================== */
239 | 
240 | /**
241 |  * Known limitation: by default, Chrome and Safari on OS X allow very limited
242 |  * styling of `select`, unless a `border` property is set.
243 |  */
244 | 
245 | /**
246 |  * 1. Correct color not being inherited.
247 |  *    Known issue: affects color of disabled elements.
248 |  * 2. Correct font properties not being inherited.
249 |  * 3. Address margins set differently in Firefox 4+, Safari, and Chrome.
250 |  */
251 | 
252 | button,
253 | input,
254 | optgroup,
255 | select,
256 | textarea {
257 |   color: inherit; /* 1 */
258 |   font: inherit; /* 2 */
259 |   margin: 0; /* 3 */
260 | }
261 | 
262 | /**
263 |  * Address `overflow` set to `hidden` in IE 8/9/10/11.
264 |  */
265 | 
266 | button {
267 |   overflow: visible;
268 | }
269 | 
270 | /**
271 |  * Address inconsistent `text-transform` inheritance for `button` and `select`.
272 |  * All other form control elements do not inherit `text-transform` values.
273 |  * Correct `button` style inheritance in Firefox, IE 8/9/10/11, and Opera.
274 |  * Correct `select` style inheritance in Firefox.
275 |  */
276 | 
277 | button,
278 | select {
279 |   text-transform: none;
280 | }
281 | 
282 | /**
283 |  * 1. Avoid the WebKit bug in Android 4.0.* where (2) destroys native `audio`
284 |  *    and `video` controls.
285 |  * 2. Correct inability to style clickable `input` types in iOS.
286 |  * 3. Improve usability and consistency of cursor style between image-type
287 |  *    `input` and others.
288 |  */
289 | 
290 | button,
291 | html input[type="button"], /* 1 */
292 | input[type="reset"],
293 | input[type="submit"] {
294 |   -webkit-appearance: button; /* 2 */
295 |   cursor: pointer; /* 3 */
296 | }
297 | 
298 | /**
299 |  * Re-set default cursor for disabled elements.
300 |  */
301 | 
302 | button[disabled],
303 | html input[disabled] {
304 |   cursor: default;
305 | }
306 | 
307 | /**
308 |  * Remove inner padding and border in Firefox 4+.
309 |  */
310 | 
311 | button::-moz-focus-inner,
312 | input::-moz-focus-inner {
313 |   border: 0;
314 |   padding: 0;
315 | }
316 | 
317 | /**
318 |  * Address Firefox 4+ setting `line-height` on `input` using `!important` in
319 |  * the UA stylesheet.
320 |  */
321 | 
322 | input {
323 |   line-height: normal;
324 | }
325 | 
326 | /**
327 |  * It's recommended that you don't attempt to style these elements.
328 |  * Firefox's implementation doesn't respect box-sizing, padding, or width.
329 |  *
330 |  * 1. Address box sizing set to `content-box` in IE 8/9/10.
331 |  * 2. Remove excess padding in IE 8/9/10.
332 |  */
333 | 
334 | input[type="checkbox"],
335 | input[type="radio"] {
336 |   box-sizing: border-box; /* 1 */
337 |   padding: 0; /* 2 */
338 | }
339 | 
340 | /**
341 |  * Fix the cursor style for Chrome's increment/decrement buttons. For certain
342 |  * `font-size` values of the `input`, it causes the cursor style of the
343 |  * decrement button to change from `default` to `text`.
344 |  */
345 | 
346 | input[type="number"]::-webkit-inner-spin-button,
347 | input[type="number"]::-webkit-outer-spin-button {
348 |   height: auto;
349 | }
350 | 
351 | /**
352 |  * 1. Address `appearance` set to `searchfield` in Safari and Chrome.
353 |  * 2. Address `box-sizing` set to `border-box` in Safari and Chrome
354 |  *    (include `-moz` to future-proof).
355 |  */
356 | 
357 | input[type="search"] {
358 |   -webkit-appearance: textfield; /* 1 */
359 |   -moz-box-sizing: content-box;
360 |   -webkit-box-sizing: content-box; /* 2 */
361 |   box-sizing: content-box;
362 | }
363 | 
364 | /**
365 |  * Remove inner padding and search cancel button in Safari and Chrome on OS X.
366 |  * Safari (but not Chrome) clips the cancel button when the search input has
367 |  * padding (and `textfield` appearance).
368 |  */
369 | 
370 | input[type="search"]::-webkit-search-cancel-button,
371 | input[type="search"]::-webkit-search-decoration {
372 |   -webkit-appearance: none;
373 | }
374 | 
375 | /**
376 |  * Define consistent border, margin, and padding.
377 |  */
378 | 
379 | fieldset {
380 |   border: 1px solid #c0c0c0;
381 |   margin: 0 2px;
382 |   padding: 0.35em 0.625em 0.75em;
383 | }
384 | 
385 | /**
386 |  * 1. Correct `color` not being inherited in IE 8/9/10/11.
387 |  * 2. Remove padding so people aren't caught out if they zero out fieldsets.
388 |  */
389 | 
390 | legend {
391 |   border: 0; /* 1 */
392 |   padding: 0; /* 2 */
393 | }
394 | 
395 | /**
396 |  * Remove default vertical scrollbar in IE 8/9/10/11.
397 |  */
398 | 
399 | textarea {
400 |   overflow: auto;
401 | }
402 | 
403 | /**
404 |  * Don't inherit the `font-weight` (applied by a rule above).
405 |  * NOTE: the default cannot safely be changed in Chrome and Safari on OS X.
406 |  */
407 | 
408 | optgroup {
409 |   font-weight: bold;
410 | }
411 | 
412 | /* Tables
413 |    ========================================================================== */
414 | 
415 | /**
416 |  * Remove most spacing between table cells.
417 |  */
418 | 
419 | table {
420 |   border-collapse: collapse;
421 |   border-spacing: 0;
422 | }
423 | 
424 | td,
425 | th {
426 |   padding: 0;
427 | }


--------------------------------------------------------------------------------
/app/css/skeleton.css:
--------------------------------------------------------------------------------
  1 | /*
  2 | * Skeleton V2.0.4
  3 | * Copyright 2014, Dave Gamache
  4 | * www.getskeleton.com
  5 | * Free to use under the MIT license.
  6 | * http://www.opensource.org/licenses/mit-license.php
  7 | * 12/29/2014
  8 | */
  9 | 
 10 | 
 11 | /* Table of contents
 12 | ––––––––––––––––––––––––––––––––––––––––––––––––––
 13 | - Grid
 14 | - Base Styles
 15 | - Typography
 16 | - Links
 17 | - Buttons
 18 | - Forms
 19 | - Lists
 20 | - Code
 21 | - Tables
 22 | - Spacing
 23 | - Utilities
 24 | - Clearing
 25 | - Media Queries
 26 | */
 27 | 
 28 | 
 29 | /* Grid
 30 | –––––––––––––––––––––––––––––––––––––––––––––––––– */
 31 | .container {
 32 |   position: relative;
 33 |   width: 100%;
 34 |   max-width: 960px;
 35 |   margin: 0 auto;
 36 |   padding: 0 20px;
 37 |   box-sizing: border-box; }
 38 | .column,
 39 | .columns {
 40 |   width: 100%;
 41 |   float: left;
 42 |   box-sizing: border-box; }
 43 | 
 44 | /* For devices larger than 400px */
 45 | @media (min-width: 400px) {
 46 |   .container {
 47 |     width: 85%;
 48 |     padding: 0; }
 49 | }
 50 | 
 51 | /* For devices larger than 550px */
 52 | @media (min-width: 550px) {
 53 |   .container {
 54 |     width: 80%; }
 55 |   .column,
 56 |   .columns {
 57 |     margin-left: 4%; }
 58 |   .column:first-child,
 59 |   .columns:first-child {
 60 |     margin-left: 0; }
 61 | 
 62 |   .one.column,
 63 |   .one.columns                    { width: 4.66666666667%; }
 64 |   .two.columns                    { width: 13.3333333333%; }
 65 |   .three.columns                  { width: 22%;            }
 66 |   .four.columns                   { width: 30.6666666667%; }
 67 |   .five.columns                   { width: 39.3333333333%; }
 68 |   .six.columns                    { width: 48%;            }
 69 |   .seven.columns                  { width: 56.6666666667%; }
 70 |   .eight.columns                  { width: 65.3333333333%; }
 71 |   .nine.columns                   { width: 74.0%;          }
 72 |   .ten.columns                    { width: 82.6666666667%; }
 73 |   .eleven.columns                 { width: 91.3333333333%; }
 74 |   .twelve.columns                 { width: 100%; margin-left: 0; }
 75 | 
 76 |   .one-third.column               { width: 30.6666666667%; }
 77 |   .two-thirds.column              { width: 65.3333333333%; }
 78 | 
 79 |   .one-half.column                { width: 48%; }
 80 | 
 81 |   /* Offsets */
 82 |   .offset-by-one.column,
 83 |   .offset-by-one.columns          { margin-left: 8.66666666667%; }
 84 |   .offset-by-two.column,
 85 |   .offset-by-two.columns          { margin-left: 17.3333333333%; }
 86 |   .offset-by-three.column,
 87 |   .offset-by-three.columns        { margin-left: 26%;            }
 88 |   .offset-by-four.column,
 89 |   .offset-by-four.columns         { margin-left: 34.6666666667%; }
 90 |   .offset-by-five.column,
 91 |   .offset-by-five.columns         { margin-left: 43.3333333333%; }
 92 |   .offset-by-six.column,
 93 |   .offset-by-six.columns          { margin-left: 52%;            }
 94 |   .offset-by-seven.column,
 95 |   .offset-by-seven.columns        { margin-left: 60.6666666667%; }
 96 |   .offset-by-eight.column,
 97 |   .offset-by-eight.columns        { margin-left: 69.3333333333%; }
 98 |   .offset-by-nine.column,
 99 |   .offset-by-nine.columns         { margin-left: 78.0%;          }
100 |   .offset-by-ten.column,
101 |   .offset-by-ten.columns          { margin-left: 86.6666666667%; }
102 |   .offset-by-eleven.column,
103 |   .offset-by-eleven.columns       { margin-left: 95.3333333333%; }
104 | 
105 |   .offset-by-one-third.column,
106 |   .offset-by-one-third.columns    { margin-left: 34.6666666667%; }
107 |   .offset-by-two-thirds.column,
108 |   .offset-by-two-thirds.columns   { margin-left: 69.3333333333%; }
109 | 
110 |   .offset-by-one-half.column,
111 |   .offset-by-one-half.columns     { margin-left: 52%; }
112 | 
113 | }
114 | 
115 | 
116 | /* Base Styles
117 | –––––––––––––––––––––––––––––––––––––––––––––––––– */
118 | /* NOTE
119 | html is set to 62.5% so that all the REM measurements throughout Skeleton
120 | are based on 10px sizing. So basically 1.5rem = 15px :) */
121 | html {
122 |   font-size: 62.5%; }
123 | body {
124 |   font-size: 1.5em; /* currently ems cause chrome bug misinterpreting rems on body element */
125 |   line-height: 1.6;
126 |   font-weight: 400;
127 |   font-family: "Raleway", "HelveticaNeue", "Helvetica Neue", Helvetica, Arial, sans-serif;
128 |   color: #222; }
129 | 
130 | 
131 | /* Typography
132 | –––––––––––––––––––––––––––––––––––––––––––––––––– */
133 | h1, h2, h3, h4, h5, h6 {
134 |   margin-top: 0;
135 |   margin-bottom: 2rem;
136 |   font-weight: 300; }
137 | h1 { font-size: 4.0rem; line-height: 1.2;  letter-spacing: -.1rem;}
138 | h2 { font-size: 3.6rem; line-height: 1.25; letter-spacing: -.1rem; }
139 | h3 { font-size: 3.0rem; line-height: 1.3;  letter-spacing: -.1rem; }
140 | h4 { font-size: 2.4rem; line-height: 1.35; letter-spacing: -.08rem; }
141 | h5 { font-size: 1.8rem; line-height: 1.5;  letter-spacing: -.05rem; }
142 | h6 { font-size: 1.5rem; line-height: 1.6;  letter-spacing: 0; }
143 | 
144 | /* Larger than phablet */
145 | @media (min-width: 550px) {
146 |   h1 { font-size: 5.0rem; }
147 |   h2 { font-size: 4.2rem; }
148 |   h3 { font-size: 3.6rem; }
149 |   h4 { font-size: 3.0rem; }
150 |   h5 { font-size: 2.4rem; }
151 |   h6 { font-size: 1.5rem; }
152 | }
153 | 
154 | p {
155 |   margin-top: 0; }
156 | 
157 | 
158 | /* Links
159 | –––––––––––––––––––––––––––––––––––––––––––––––––– */
160 | a {
161 |   color: #1EAEDB; }
162 | a:hover {
163 |   color: #0FA0CE; }
164 | 
165 | 
166 | /* Buttons
167 | –––––––––––––––––––––––––––––––––––––––––––––––––– */
168 | .button,
169 | button,
170 | input[type="submit"],
171 | input[type="reset"],
172 | input[type="button"] {
173 |   display: inline-block;
174 |   height: 38px;
175 |   padding: 0 30px;
176 |   color: #555;
177 |   text-align: center;
178 |   font-size: 11px;
179 |   font-weight: 600;
180 |   line-height: 38px;
181 |   letter-spacing: .1rem;
182 |   text-transform: uppercase;
183 |   text-decoration: none;
184 |   white-space: nowrap;
185 |   background-color: transparent;
186 |   border-radius: 4px;
187 |   border: 1px solid #bbb;
188 |   cursor: pointer;
189 |   box-sizing: border-box; }
190 | .button:hover,
191 | button:hover,
192 | input[type="submit"]:hover,
193 | input[type="reset"]:hover,
194 | input[type="button"]:hover,
195 | .button:focus,
196 | button:focus,
197 | input[type="submit"]:focus,
198 | input[type="reset"]:focus,
199 | input[type="button"]:focus {
200 |   color: #333;
201 |   border-color: #888;
202 |   outline: 0; }
203 | .button.button-primary,
204 | button.button-primary,
205 | input[type="submit"].button-primary,
206 | input[type="reset"].button-primary,
207 | input[type="button"].button-primary {
208 |   color: #FFF;
209 |   background-color: #33C3F0;
210 |   border-color: #33C3F0; }
211 | .button.button-primary:hover,
212 | button.button-primary:hover,
213 | input[type="submit"].button-primary:hover,
214 | input[type="reset"].button-primary:hover,
215 | input[type="button"].button-primary:hover,
216 | .button.button-primary:focus,
217 | button.button-primary:focus,
218 | input[type="submit"].button-primary:focus,
219 | input[type="reset"].button-primary:focus,
220 | input[type="button"].button-primary:focus {
221 |   color: #FFF;
222 |   background-color: #1EAEDB;
223 |   border-color: #1EAEDB; }
224 | 
225 | 
226 | /* Forms
227 | –––––––––––––––––––––––––––––––––––––––––––––––––– */
228 | input[type="email"],
229 | input[type="number"],
230 | input[type="search"],
231 | input[type="text"],
232 | input[type="tel"],
233 | input[type="url"],
234 | input[type="password"],
235 | textarea,
236 | select {
237 |   height: 38px;
238 |   padding: 6px 10px; /* The 6px vertically centers text on FF, ignored by Webkit */
239 |   background-color: #fff;
240 |   border: 1px solid #D1D1D1;
241 |   border-radius: 4px;
242 |   box-shadow: none;
243 |   box-sizing: border-box; }
244 | /* Removes awkward default styles on some inputs for iOS */
245 | input[type="email"],
246 | input[type="number"],
247 | input[type="search"],
248 | input[type="text"],
249 | input[type="tel"],
250 | input[type="url"],
251 | input[type="password"],
252 | textarea {
253 |   -webkit-appearance: none;
254 |      -moz-appearance: none;
255 |           appearance: none; }
256 | textarea {
257 |   min-height: 65px;
258 |   padding-top: 6px;
259 |   padding-bottom: 6px; }
260 | input[type="email"]:focus,
261 | input[type="number"]:focus,
262 | input[type="search"]:focus,
263 | input[type="text"]:focus,
264 | input[type="tel"]:focus,
265 | input[type="url"]:focus,
266 | input[type="password"]:focus,
267 | textarea:focus,
268 | select:focus {
269 |   border: 1px solid #33C3F0;
270 |   outline: 0; }
271 | label,
272 | legend {
273 |   display: block;
274 |   margin-bottom: .5rem;
275 |   font-weight: 600; }
276 | fieldset {
277 |   padding: 0;
278 |   border-width: 0; }
279 | input[type="checkbox"],
280 | input[type="radio"] {
281 |   display: inline; }
282 | label > .label-body {
283 |   display: inline-block;
284 |   margin-left: .5rem;
285 |   font-weight: normal; }
286 | 
287 | 
288 | /* Lists
289 | –––––––––––––––––––––––––––––––––––––––––––––––––– */
290 | ul {
291 |   list-style: circle inside; }
292 | ol {
293 |   list-style: decimal inside; }
294 | ol, ul {
295 |   padding-left: 0;
296 |   margin-top: 0; }
297 | ul ul,
298 | ul ol,
299 | ol ol,
300 | ol ul {
301 |   margin: 1.5rem 0 1.5rem 3rem;
302 |   font-size: 90%; }
303 | li {
304 |   margin-bottom: 1rem; }
305 | 
306 | 
307 | /* Code
308 | –––––––––––––––––––––––––––––––––––––––––––––––––– */
309 | code {
310 |   padding: .2rem .5rem;
311 |   margin: 0 .2rem;
312 |   font-size: 90%;
313 |   white-space: nowrap;
314 |   background: #F1F1F1;
315 |   border: 1px solid #E1E1E1;
316 |   border-radius: 4px; }
317 | pre > code {
318 |   display: block;
319 |   padding: 1rem 1.5rem;
320 |   white-space: pre; }
321 | 
322 | 
323 | /* Tables
324 | –––––––––––––––––––––––––––––––––––––––––––––––––– */
325 | th,
326 | td {
327 |   padding: 12px 15px;
328 |   text-align: left;
329 |   border-bottom: 1px solid #E1E1E1; }
330 | th:first-child,
331 | td:first-child {
332 |   padding-left: 0; }
333 | th:last-child,
334 | td:last-child {
335 |   padding-right: 0; }
336 | 
337 | 
338 | /* Spacing
339 | –––––––––––––––––––––––––––––––––––––––––––––––––– */
340 | button,
341 | .button {
342 |   margin-bottom: 1rem; }
343 | input,
344 | textarea,
345 | select,
346 | fieldset {
347 |   margin-bottom: 1.5rem; }
348 | pre,
349 | blockquote,
350 | dl,
351 | figure,
352 | table,
353 | p,
354 | ul,
355 | ol,
356 | form {
357 |   margin-bottom: 2.5rem; }
358 | 
359 | 
360 | /* Utilities
361 | –––––––––––––––––––––––––––––––––––––––––––––––––– */
362 | .u-full-width {
363 |   width: 100%;
364 |   box-sizing: border-box; }
365 | .u-max-full-width {
366 |   max-width: 100%;
367 |   box-sizing: border-box; }
368 | .u-pull-right {
369 |   float: right; }
370 | .u-pull-left {
371 |   float: left; }
372 | 
373 | 
374 | /* Misc
375 | –––––––––––––––––––––––––––––––––––––––––––––––––– */
376 | hr {
377 |   margin-top: 3rem;
378 |   margin-bottom: 3.5rem;
379 |   border-width: 0;
380 |   border-top: 1px solid #E1E1E1; }
381 | 
382 | 
383 | /* Clearing
384 | –––––––––––––––––––––––––––––––––––––––––––––––––– */
385 | 
386 | /* Self Clearing Goodness */
387 | .container:after,
388 | .row:after,
389 | .u-cf {
390 |   content: "";
391 |   display: table;
392 |   clear: both; }
393 | 
394 | 
395 | /* Media Queries
396 | –––––––––––––––––––––––––––––––––––––––––––––––––– */
397 | /*
398 | Note: The best way to structure the use of media queries is to create the queries
399 | near the relevant code. For example, if you wanted to change the styles for buttons
400 | on small devices, paste the mobile query code up in the buttons section and style it
401 | there.
402 | */
403 | 
404 | 
405 | /* Larger than mobile */
406 | @media (min-width: 400px) {}
407 | 
408 | /* Larger than phablet (also point when grid becomes active) */
409 | @media (min-width: 550px) {}
410 | 
411 | /* Larger than tablet */
412 | @media (min-width: 750px) {}
413 | 
414 | /* Larger than desktop */
415 | @media (min-width: 1000px) {}
416 | 
417 | /* Larger than Desktop HD */
418 | @media (min-width: 1200px) {}
419 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
  1 |                                  Apache License
  2 |                            Version 2.0, January 2004
  3 |                         http://www.apache.org/licenses/
  4 | 
  5 |    TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
  6 | 
  7 |    1. Definitions.
  8 | 
  9 |       "License" shall mean the terms and conditions for use, reproduction,
 10 |       and distribution as defined by Sections 1 through 9 of this document.
 11 | 
 12 |       "Licensor" shall mean the copyright owner or entity authorized by
 13 |       the copyright owner that is granting the License.
 14 | 
 15 |       "Legal Entity" shall mean the union of the acting entity and all
 16 |       other entities that control, are controlled by, or are under common
 17 |       control with that entity. For the purposes of this definition,
 18 |       "control" means (i) the power, direct or indirect, to cause the
 19 |       direction or management of such entity, whether by contract or
 20 |       otherwise, or (ii) ownership of fifty percent (50%) or more of the
 21 |       outstanding shares, or (iii) beneficial ownership of such entity.
 22 | 
 23 |       "You" (or "Your") shall mean an individual or Legal Entity
 24 |       exercising permissions granted by this License.
 25 | 
 26 |       "Source" form shall mean the preferred form for making modifications,
 27 |       including but not limited to software source code, documentation
 28 |       source, and configuration files.
 29 | 
 30 |       "Object" form shall mean any form resulting from mechanical
 31 |       transformation or translation of a Source form, including but
 32 |       not limited to compiled object code, generated documentation,
 33 |       and conversions to other media types.
 34 | 
 35 |       "Work" shall mean the work of authorship, whether in Source or
 36 |       Object form, made available under the License, as indicated by a
 37 |       copyright notice that is included in or attached to the work
 38 |       (an example is provided in the Appendix below).
 39 | 
 40 |       "Derivative Works" shall mean any work, whether in Source or Object
 41 |       form, that is based on (or derived from) the Work and for which the
 42 |       editorial revisions, annotations, elaborations, or other modifications
 43 |       represent, as a whole, an original work of authorship. For the purposes
 44 |       of this License, Derivative Works shall not include works that remain
 45 |       separable from, or merely link (or bind by name) to the interfaces of,
 46 |       the Work and Derivative Works thereof.
 47 | 
 48 |       "Contribution" shall mean any work of authorship, including
 49 |       the original version of the Work and any modifications or additions
 50 |       to that Work or Derivative Works thereof, that is intentionally
 51 |       submitted to Licensor for inclusion in the Work by the copyright owner
 52 |       or by an individual or Legal Entity authorized to submit on behalf of
 53 |       the copyright owner. For the purposes of this definition, "submitted"
 54 |       means any form of electronic, verbal, or written communication sent
 55 |       to the Licensor or its representatives, including but not limited to
 56 |       communication on electronic mailing lists, source code control systems,
 57 |       and issue tracking systems that are managed by, or on behalf of, the
 58 |       Licensor for the purpose of discussing and improving the Work, but
 59 |       excluding communication that is conspicuously marked or otherwise
 60 |       designated in writing by the copyright owner as "Not a Contribution."
 61 | 
 62 |       "Contributor" shall mean Licensor and any individual or Legal Entity
 63 |       on behalf of whom a Contribution has been received by Licensor and
 64 |       subsequently incorporated within the Work.
 65 | 
 66 |    2. Grant of Copyright License. Subject to the terms and conditions of
 67 |       this License, each Contributor hereby grants to You a perpetual,
 68 |       worldwide, non-exclusive, no-charge, royalty-free, irrevocable
 69 |       copyright license to reproduce, prepare Derivative Works of,
 70 |       publicly display, publicly perform, sublicense, and distribute the
 71 |       Work and such Derivative Works in Source or Object form.
 72 | 
 73 |    3. Grant of Patent License. Subject to the terms and conditions of
 74 |       this License, each Contributor hereby grants to You a perpetual,
 75 |       worldwide, non-exclusive, no-charge, royalty-free, irrevocable
 76 |       (except as stated in this section) patent license to make, have made,
 77 |       use, offer to sell, sell, import, and otherwise transfer the Work,
 78 |       where such license applies only to those patent claims licensable
 79 |       by such Contributor that are necessarily infringed by their
 80 |       Contribution(s) alone or by combination of their Contribution(s)
 81 |       with the Work to which such Contribution(s) was submitted. If You
 82 |       institute patent litigation against any entity (including a
 83 |       cross-claim or counterclaim in a lawsuit) alleging that the Work
 84 |       or a Contribution incorporated within the Work constitutes direct
 85 |       or contributory patent infringement, then any patent licenses
 86 |       granted to You under this License for that Work shall terminate
 87 |       as of the date such litigation is filed.
 88 | 
 89 |    4. Redistribution. You may reproduce and distribute copies of the
 90 |       Work or Derivative Works thereof in any medium, with or without
 91 |       modifications, and in Source or Object form, provided that You
 92 |       meet the following conditions:
 93 | 
 94 |       (a) You must give any other recipients of the Work or
 95 |           Derivative Works a copy of this License; and
 96 | 
 97 |       (b) You must cause any modified files to carry prominent notices
 98 |           stating that You changed the files; and
 99 | 
100 |       (c) You must retain, in the Source form of any Derivative Works
101 |           that You distribute, all copyright, patent, trademark, and
102 |           attribution notices from the Source form of the Work,
103 |           excluding those notices that do not pertain to any part of
104 |           the Derivative Works; and
105 | 
106 |       (d) If the Work includes a "NOTICE" text file as part of its
107 |           distribution, then any Derivative Works that You distribute must
108 |           include a readable copy of the attribution notices contained
109 |           within such NOTICE file, excluding those notices that do not
110 |           pertain to any part of the Derivative Works, in at least one
111 |           of the following places: within a NOTICE text file distributed
112 |           as part of the Derivative Works; within the Source form or
113 |           documentation, if provided along with the Derivative Works; or,
114 |           within a display generated by the Derivative Works, if and
115 |           wherever such third-party notices normally appear. The contents
116 |           of the NOTICE file are for informational purposes only and
117 |           do not modify the License. You may add Your own attribution
118 |           notices within Derivative Works that You distribute, alongside
119 |           or as an addendum to the NOTICE text from the Work, provided
120 |           that such additional attribution notices cannot be construed
121 |           as modifying the License.
122 | 
123 |       You may add Your own copyright statement to Your modifications and
124 |       may provide additional or different license terms and conditions
125 |       for use, reproduction, or distribution of Your modifications, or
126 |       for any such Derivative Works as a whole, provided Your use,
127 |       reproduction, and distribution of the Work otherwise complies with
128 |       the conditions stated in this License.
129 | 
130 |    5. Submission of Contributions. Unless You explicitly state otherwise,
131 |       any Contribution intentionally submitted for inclusion in the Work
132 |       by You to the Licensor shall be under the terms and conditions of
133 |       this License, without any additional terms or conditions.
134 |       Notwithstanding the above, nothing herein shall supersede or modify
135 |       the terms of any separate license agreement you may have executed
136 |       with Licensor regarding such Contributions.
137 | 
138 |    6. Trademarks. This License does not grant permission to use the trade
139 |       names, trademarks, service marks, or product names of the Licensor,
140 |       except as required for reasonable and customary use in describing the
141 |       origin of the Work and reproducing the content of the NOTICE file.
142 | 
143 |    7. Disclaimer of Warranty. Unless required by applicable law or
144 |       agreed to in writing, Licensor provides the Work (and each
145 |       Contributor provides its Contributions) on an "AS IS" BASIS,
146 |       WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147 |       implied, including, without limitation, any warranties or conditions
148 |       of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149 |       PARTICULAR PURPOSE. You are solely responsible for determining the
150 |       appropriateness of using or redistributing the Work and assume any
151 |       risks associated with Your exercise of permissions under this License.
152 | 
153 |    8. Limitation of Liability. In no event and under no legal theory,
154 |       whether in tort (including negligence), contract, or otherwise,
155 |       unless required by applicable law (such as deliberate and grossly
156 |       negligent acts) or agreed to in writing, shall any Contributor be
157 |       liable to You for damages, including any direct, indirect, special,
158 |       incidental, or consequential damages of any character arising as a
159 |       result of this License or out of the use or inability to use the
160 |       Work (including but not limited to damages for loss of goodwill,
161 |       work stoppage, computer failure or malfunction, or any and all
162 |       other commercial damages or losses), even if such Contributor
163 |       has been advised of the possibility of such damages.
164 | 
165 |    9. Accepting Warranty or Additional Liability. While redistributing
166 |       the Work or Derivative Works thereof, You may choose to offer,
167 |       and charge a fee for, acceptance of support, warranty, indemnity,
168 |       or other liability obligations and/or rights consistent with this
169 |       License. However, in accepting such obligations, You may act only
170 |       on Your own behalf and on Your sole responsibility, not on behalf
171 |       of any other Contributor, and only if You agree to indemnify,
172 |       defend, and hold each Contributor harmless for any liability
173 |       incurred by, or claims asserted against, such Contributor by reason
174 |       of your accepting any such warranty or additional liability.
175 | 
176 |    END OF TERMS AND CONDITIONS
177 | 
178 |    APPENDIX: How to apply the Apache License to your work.
179 | 
180 |       To apply the Apache License to your work, attach the following
181 |       boilerplate notice, with the fields enclosed by brackets "{}"
182 |       replaced with your own identifying information. (Don't include
183 |       the brackets!)  The text should be enclosed in the appropriate
184 |       comment syntax for the file format. We also recommend that a
185 |       file or class name and description of purpose be included on the
186 |       same "printed page" as the copyright notice for easier
187 |       identification within third-party archives.
188 | 
189 |    Copyright {yyyy} {name of copyright owner}
190 | 
191 |    Licensed under the Apache License, Version 2.0 (the "License");
192 |    you may not use this file except in compliance with the License.
193 |    You may obtain a copy of the License at
194 | 
195 |        http://www.apache.org/licenses/LICENSE-2.0
196 | 
197 |    Unless required by applicable law or agreed to in writing, software
198 |    distributed under the License is distributed on an "AS IS" BASIS,
199 |    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200 |    See the License for the specific language governing permissions and
201 |    limitations under the License.
202 | 


--------------------------------------------------------------------------------