├── public └── .gitkeep ├── src ├── view │ └── .gitkeep ├── middleware │ └── .gitkeep ├── services │ └── .gitkeep ├── config │ └── database.js ├── models │ └── user.js ├── routes │ └── api.js ├── validations │ └── Api │ │ └── V1 │ │ └── UserValidation.js └── controllers │ └── Api │ └── V1 │ └── AuthController.js ├── .env.example ├── app.js ├── .github └── workflows │ └── node.js.yml ├── package.json ├── README.md ├── .gitignore └── LICENSE /public/.gitkeep: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /src/view/.gitkeep: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /src/middleware/.gitkeep: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /src/services/.gitkeep: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.env.example: -------------------------------------------------------------------------------- 1 | NODE_ENV=development 2 | PORT=3000 3 | 4 | # Mysql Database 5 | DB_HOST=localhost 6 | DB_PORT=3306 7 | DB_SECRET=secret 8 | DB_CONNECTION=mysql 9 | DB_USERNAME= 10 | DB_PASSWORD= 11 | DB_NAME= 12 | -------------------------------------------------------------------------------- /src/config/database.js: -------------------------------------------------------------------------------- 1 | const mysql = require("mysql2"); 2 | 3 | const conn = mysql.createConnection({ 4 | host: process.env.DB_HOST, 5 | port: process.env.DB_PORT, 6 | user: process.env.DB_USERNAME, 7 | password: process.env.DB_PASSWORD, 8 | database: process.env.DB_NAME, 9 | }); 10 | 11 | module.exports = conn; 12 | -------------------------------------------------------------------------------- /src/models/user.js: -------------------------------------------------------------------------------- 1 | const db = require("../config/database"); 2 | 3 | const User = { 4 | create: (user) => { 5 | return db 6 | .promise() 7 | .execute( 8 | "INSERT INTO users (username, email, password) VALUES (?, ?, ?)", 9 | [user.username, user.email, user.password] 10 | ); 11 | }, 12 | 13 | findByEmail: (email) => { 14 | return db.promise().query("SELECT * FROM users WHERE email = ?", [email]); 15 | }, 16 | }; 17 | 18 | module.exports = User; 19 | -------------------------------------------------------------------------------- /src/routes/api.js: -------------------------------------------------------------------------------- 1 | const express = require("express"); 2 | const router = express.Router(); 3 | 4 | const authController = require("../controllers/Api/V1/AuthController"); 5 | 6 | const { 7 | userRegisterValidationRules, 8 | userLoginValidationRules, 9 | } = require("../validations/Api/V1/UserValidation"); 10 | 11 | 12 | router.post( 13 | "/register", 14 | userRegisterValidationRules(), 15 | authController.register 16 | ); 17 | router.post("/login", userLoginValidationRules(), authController.login); 18 | 19 | module.exports = router; 20 | -------------------------------------------------------------------------------- /app.js: -------------------------------------------------------------------------------- 1 | const express = require('express'); 2 | const app = express(); 3 | const cors = require('cors'); 4 | 5 | const apiRoutes = require('./src/routes/api'); 6 | const bodyParser = require('body-parser'); 7 | 8 | const port = process.env.PORT || 3000; 9 | 10 | //middleware 11 | app.use(bodyParser.json()); 12 | app.use(express.json()); 13 | app.use(cors()); // Allow all origins (not recommended for production) 14 | 15 | //routes 16 | app.use('/v1', apiRoutes); 17 | 18 | app.listen(port, () => { 19 | console.log(`Server is running on port ${port}`); 20 | }); 21 | -------------------------------------------------------------------------------- /.github/workflows/node.js.yml: -------------------------------------------------------------------------------- 1 | # This workflow will do a clean installation of node dependencies, cache/restore them, build the source code and run tests across different versions of node 2 | # For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-nodejs 3 | 4 | name: Node.js CI 5 | 6 | on: 7 | push: 8 | branches: [ "main" ] 9 | pull_request: 10 | branches: [ "main" ] 11 | 12 | jobs: 13 | build: 14 | 15 | runs-on: ubuntu-latest 16 | 17 | strategy: 18 | matrix: 19 | node-version: [16.x, 18.x] 20 | # See supported Node.js release schedule at https://nodejs.org/en/about/releases/ 21 | 22 | steps: 23 | - uses: actions/checkout@v3 24 | - name: Use Node.js ${{ matrix.node-version }} 25 | uses: actions/setup-node@v3 26 | with: 27 | node-version: ${{ matrix.node-version }} 28 | cache: 'npm' 29 | - run: npm ci 30 | - run: npm run build --if-present 31 | -------------------------------------------------------------------------------- /package.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "expressjs-auth", 3 | "version": "1.0.0", 4 | "description": "Expressjs authentication", 5 | "main": "app.js", 6 | "scripts": { 7 | "test": "nodemon app.js" 8 | }, 9 | "repository": { 10 | "type": "git", 11 | "url": "git+https://github.com/supuna97/expressjs-auth.git" 12 | }, 13 | "keywords": [ 14 | "nodejs", 15 | "expressjs", 16 | "authentication", 17 | "expressjs-auth", 18 | "expressjs-authentication" 19 | ], 20 | "author": "Supun Nanayakkara", 21 | "license": "ISC", 22 | "bugs": { 23 | "url": "https://github.com/supuna97/expressjs-auth/issues" 24 | }, 25 | "homepage": "https://github.com/supuna97/expressjs-auth#readme", 26 | "dependencies": { 27 | "bcrypt": "^5.1.1", 28 | "body-parser": "^1.20.2", 29 | "cors": "^2.8.5", 30 | "dotenv": "^16.3.1", 31 | "express": "^4.19.2", 32 | "express-cors": "^0.0.3", 33 | "express-validator": "^7.0.1", 34 | "jsonwebtoken": "^9.0.2", 35 | "mysql": "^2.18.1", 36 | "mysql2": "^3.9.8", 37 | "nodemon": "^3.0.1", 38 | "sequelize": "^6.33.0" 39 | } 40 | } 41 | -------------------------------------------------------------------------------- /src/validations/Api/V1/UserValidation.js: -------------------------------------------------------------------------------- 1 | const { body } = require("express-validator"); 2 | 3 | const userRegisterValidationRules = () => { 4 | return [ 5 | body("username") 6 | .notEmpty() 7 | .isLength({ min: 3, max: 20 }) 8 | .withMessage("Username must be between 3 and 20 characters"), 9 | 10 | body("password") 11 | .notEmpty() 12 | .isLength({ min: 8, max: 20 }) 13 | .withMessage("Password must be between 8 and 20 characters"), 14 | 15 | body("email") 16 | .notEmpty() 17 | .isEmail() 18 | .withMessage("Invalid email address") 19 | .isLength({ min: 5 }) 20 | .withMessage("Email must be at least 5 characters"), 21 | ]; 22 | }; 23 | 24 | const userLoginValidationRules = () => { 25 | return [ 26 | body("email") 27 | .notEmpty() 28 | .isEmail() 29 | .withMessage("Invalid email address"), 30 | 31 | body("password") 32 | .notEmpty() 33 | .isLength({ min: 8, max: 20 }) 34 | .withMessage("Password must be between 8 and 20 characters"), 35 | ]; 36 | }; 37 | 38 | module.exports = { 39 | userRegisterValidationRules, 40 | userLoginValidationRules, 41 | }; 42 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Expressjs Authentication REST APIs with JWT Token 2 | 3 | ## Project technologies/tools 4 | - Node.js 5 | - Express.js 6 | - NODEMON 7 | - JWT 8 | - BCRYPTJS 9 | - JOI 10 | - DOTENV 11 | - MYSQL2 12 | - Postman 13 | 14 | ## Project setup 15 | ``` 16 | npm init 17 | ``` 18 | 19 | ### Install dependencies 20 | 21 | ``` 22 | npm install express 23 | ``` 24 | 25 | ``` 26 | npm install nodemon 27 | ``` 28 | 29 | ``` 30 | npm install jsonwebtoken 31 | ``` 32 | 33 | ``` 34 | npm install bcryptjs 35 | ``` 36 | 37 | ``` 38 | npm install joi 39 | ``` 40 | 41 | ``` 42 | npm install dotenv 43 | ``` 44 | 45 | ``` 46 | npm install mysql2 47 | ``` 48 | 49 | ### app.js 50 | - Create app.js file 51 | 52 | ### Compiles and hot-reloads for development using nodemon 53 | 54 | ``` 55 | nodemon app.js 56 | ``` 57 | 58 | ### Customize configuration 59 | - See [Configuration Reference](https://expressjs.com/). 60 | 61 | ### Postman 62 | - See [Postman](https://www.postman.com/). 63 | 64 | ### MySQL 65 | - See [MySQL](https://www.mysql.com/). 66 | 67 | ### JWT 68 | - See [JWT](https://jwt.io/). 69 | 70 | ### BCRYPTJS 71 | - See [BCRYPTJS](https://www.npmjs.com/package/bcryptjs). 72 | 73 | ### JOI 74 | - See [JOI](https://www.npmjs.com/package/joi). 75 | 76 | ### DOTENV 77 | - See [DOTENV](https://www.npmjs.com/package/dotenv). 78 | 79 | ### MYSQL2 80 | - See [MYSQL2](https://www.npmjs.com/package/mysql2). 81 | 82 | ### Expressjs 83 | - See [Expressjs](https://expressjs.com/). 84 | 85 | ### Nodejs 86 | - See [Nodejs](https://nodejs.org/en/). 87 | 88 | ### Nodemon 89 | - See [Nodemon](https://nodemon.io/). 90 | -------------------------------------------------------------------------------- /src/controllers/Api/V1/AuthController.js: -------------------------------------------------------------------------------- 1 | const bcrypt = require("bcrypt"); 2 | const jwt = require("jsonwebtoken"); 3 | const User = require("../../../models/User"); 4 | const { validationResult } = require("express-validator"); 5 | 6 | const authController = { 7 | register: async (req, res) => { 8 | try { 9 | // Validate the user input 10 | const errors = validationResult(req); 11 | 12 | if (!errors.isEmpty()) { 13 | return res.status(400).json({ message: errors.array() }); 14 | } 15 | 16 | const { username, email, password } = req.body; 17 | // Hash the password 18 | const hashedPassword = await bcrypt.hash(password, 10); 19 | // Create the user in the database 20 | await User.create({ username, email, password: hashedPassword }); 21 | res.status(201).json({ message: "User registered successfully" }); 22 | } catch (error) { 23 | console.error(error); 24 | res.status(500).json({ message: "Registration failed" }); 25 | } 26 | }, 27 | 28 | login: async (req, res) => { 29 | try { 30 | // Validate the user input 31 | const errors = validationResult(req); 32 | 33 | if (!errors.isEmpty()) { 34 | return res.status(400).json({ message: errors.array() }); 35 | } 36 | 37 | const { email, password } = req.body; 38 | // Find the user by email 39 | const [rows] = await User.findByEmail(email); 40 | 41 | if (rows.length === 0) { 42 | return res.status(401).json({ message: "Invalid credentials" }); 43 | } 44 | 45 | const user = rows[0]; 46 | // Compare the provided password with the hashed password 47 | const isPasswordValid = await bcrypt.compare(password, user.password); 48 | 49 | if (!isPasswordValid) { 50 | return res.status(401).json({ message: "Invalid Password" }); 51 | } 52 | 53 | // Generate a JWT token 54 | const token = jwt.sign( 55 | { userId: user.id, email: user.email }, 56 | process.env.DB_SECRET, 57 | { 58 | expiresIn: "1h", // Adjust the expiration time as needed 59 | } 60 | ); 61 | 62 | res.status(200).json({ token: token }); 63 | } catch (error) { 64 | console.error(error); 65 | res.status(500).json({ message: "Login failed" }); 66 | } 67 | }, 68 | }; 69 | 70 | module.exports = authController; 71 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | # Logs 2 | logs 3 | *.log 4 | npm-debug.log* 5 | yarn-debug.log* 6 | yarn-error.log* 7 | lerna-debug.log* 8 | .pnpm-debug.log* 9 | 10 | # Diagnostic reports (https://nodejs.org/api/report.html) 11 | report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json 12 | 13 | # Runtime data 14 | pids 15 | *.pid 16 | *.seed 17 | *.pid.lock 18 | 19 | # Directory for instrumented libs generated by jscoverage/JSCover 20 | lib-cov 21 | 22 | # Coverage directory used by tools like istanbul 23 | coverage 24 | *.lcov 25 | 26 | # nyc test coverage 27 | .nyc_output 28 | 29 | # Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files) 30 | .grunt 31 | 32 | # Bower dependency directory (https://bower.io/) 33 | bower_components 34 | 35 | # node-waf configuration 36 | .lock-wscript 37 | 38 | # Compiled binary addons (https://nodejs.org/api/addons.html) 39 | build/Release 40 | 41 | # Dependency directories 42 | node_modules/ 43 | jspm_packages/ 44 | 45 | # Snowpack dependency directory (https://snowpack.dev/) 46 | web_modules/ 47 | 48 | # TypeScript cache 49 | *.tsbuildinfo 50 | 51 | # Optional npm cache directory 52 | .npm 53 | 54 | # Optional eslint cache 55 | .eslintcache 56 | 57 | # Optional stylelint cache 58 | .stylelintcache 59 | 60 | # Microbundle cache 61 | .rpt2_cache/ 62 | .rts2_cache_cjs/ 63 | .rts2_cache_es/ 64 | .rts2_cache_umd/ 65 | 66 | # Optional REPL history 67 | .node_repl_history 68 | 69 | # Output of 'npm pack' 70 | *.tgz 71 | 72 | # Yarn Integrity file 73 | .yarn-integrity 74 | 75 | # dotenv environment variable files 76 | .env 77 | .env.development.local 78 | .env.test.local 79 | .env.production.local 80 | .env.local 81 | 82 | # parcel-bundler cache (https://parceljs.org/) 83 | .cache 84 | .parcel-cache 85 | 86 | # Next.js build output 87 | .next 88 | out 89 | 90 | # Nuxt.js build / generate output 91 | .nuxt 92 | dist 93 | 94 | # Gatsby files 95 | .cache/ 96 | # Comment in the public line in if your project uses Gatsby and not Next.js 97 | # https://nextjs.org/blog/next-9-1#public-directory-support 98 | # public 99 | 100 | # vuepress build output 101 | .vuepress/dist 102 | 103 | # vuepress v2.x temp and cache directory 104 | .temp 105 | .cache 106 | 107 | # Docusaurus cache and generated files 108 | .docusaurus 109 | 110 | # Serverless directories 111 | .serverless/ 112 | 113 | # FuseBox cache 114 | .fusebox/ 115 | 116 | # DynamoDB Local files 117 | .dynamodb/ 118 | 119 | # TernJS port file 120 | .tern-port 121 | 122 | # Stores VSCode versions used for testing VSCode extensions 123 | .vscode-test 124 | 125 | # yarn v2 126 | .yarn/cache 127 | .yarn/unplugged 128 | .yarn/build-state.yml 129 | .yarn/install-state.gz 130 | .pnp.* 131 | -------------------------------------------------------------------------------- /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 | --------------------------------------------------------------------------------