Auth service Microservice handles authentication for application. Registered applications using auth-service can make Register, Verify, login, Forgot Password, Reset Password, Change Password and Token verification requests. These requests require that you include an authorization token in the headers in order to make successful requests.
Users can register on the application
\n","urlObject":{"protocol":"http","port":"5001","path":["api","v1","auth","register"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"042167da-1f7e-4253-a43e-7593ff2f9daa","name":"Register Request","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhcHBfbmFtZSI6IndlbGNvbWUiLCJ1bmlxdWVfaWQiOiJlbWFpbCIsIm9yZ19uYW1lIjoia29saWVsaTEyMyIsImlhdCI6MTU5ODg3ODk4NCwiZXhwIjoxNjMwNDM2NTg0fQ.9HJFH_BS87Dnst8qmXhNSpgdrgOfXJzcOav0ox1E8A8","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\": \"newuser@gmail.com\",\r\n \"fullname\": \"david elik\",\r\n \"password\": \"1234567\",\r\n \"username\": \"elik123\",\r\n \"department\": \"tech dept\"\r\n\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:5001/api/v1/auth/register"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"71"},{"key":"ETag","value":"W/\"47-0C/+TMrRHE594rVZkOGECYGVWTo\""},{"key":"Date","value":"Mon, 31 Aug 2020 15:56:33 GMT"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Check your mail, a confirmation mail has been sent to you\"\n}"}],"_postman_id":"956b0bd4-25d2-4e7c-869e-97645b35e689"},{"name":"verify request","id":"923639e7-3491-4122-b7c7-474269dbd2e4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"Authorization","value":"Bearer yourAppToken","type":"text"}],"url":"http://localhost:5001/api/v1/auth/verify?email=user@email.com&token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI1ZjRkMWRhNjFkNmJkZTcyOWNhMzk3ZDQiLCJpYXQiOjE1OTg4ODkzODIsImV4cCI6MTU5ODk3NTc4Mn0.jxlc5aAx0luQBZf9HPtyzGgxvqf_PHo5ZwS62gm409c","description":"This request handles the activation link sent to the newly registered application's user.
\n","urlObject":{"protocol":"http","port":"5001","path":["api","v1","auth","verify"],"host":["localhost"],"query":[{"key":"email","value":"user@email.com"},{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI1ZjRkMWRhNjFkNmJkZTcyOWNhMzk3ZDQiLCJpYXQiOjE1OTg4ODkzODIsImV4cCI6MTU5ODk3NTc4Mn0.jxlc5aAx0luQBZf9HPtyzGgxvqf_PHo5ZwS62gm409c"}],"variable":[]}},"response":[{"id":"8dd1a519-1a75-4f1c-9ce7-3447ef25ebb3","name":"verify request","originalRequest":{"method":"PATCH","header":[{"key":"Authorization","value":"Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhcHBfbmFtZSI6IndlbGNvbWUiLCJ1bmlxdWVfaWQiOiJlbWFpbCIsIm9yZ19uYW1lIjoia29saWVsaTEyMyIsImlhdCI6MTU5ODg3ODk4NCwiZXhwIjoxNjMwNDM2NTg0fQ.9HJFH_BS87Dnst8qmXhNSpgdrgOfXJzcOav0ox1E8A8","type":"text"}],"url":{"raw":"http://localhost:5001/api/v1/auth/verify?email=newuser@gmail.com&token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI1ZjRkMWRhNjFkNmJkZTcyOWNhMzk3ZDQiLCJpYXQiOjE1OTg4ODkzODIsImV4cCI6MTU5ODk3NTc4Mn0.jxlc5aAx0luQBZf9HPtyzGgxvqf_PHo5ZwS62gm409c","protocol":"http","host":["localhost"],"port":"5001","path":["api","v1","auth","verify"],"query":[{"key":"email","value":"newuser@gmail.com"},{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI1ZjRkMWRhNjFkNmJkZTcyOWNhMzk3ZDQiLCJpYXQiOjE1OTg4ODkzODIsImV4cCI6MTU5ODk3NTc4Mn0.jxlc5aAx0luQBZf9HPtyzGgxvqf_PHo5ZwS62gm409c"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"83"},{"key":"ETag","value":"W/\"53-fFw1fHI+BjsrcLhiy8EeEhI50/U\""},{"key":"Date","value":"Mon, 31 Aug 2020 15:59:20 GMT"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Welcome on board, your account has been activated. Proceed to sign in\"\n}"}],"_postman_id":"923639e7-3491-4122-b7c7-474269dbd2e4"},{"name":"Login Request","id":"c6bece6d-befe-40ac-adb8-3cf9ecf6119b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer yourAppToken","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\": \"user1@email.com\",\r\n \"password\": \"1234567\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:5001/api/v1/auth/login","description":"Users of application can make a login request.
\n","urlObject":{"protocol":"http","port":"5001","path":["api","v1","auth","login"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"5612efb7-96cb-4ba0-91b2-23b5bf5c6dde","name":"Login Request","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhcHBfbmFtZSI6IndlbGNvbWUiLCJ1bmlxdWVfaWQiOiJlbWFpbCIsIm9yZ19uYW1lIjoia29saWVsaTEyMyIsImlhdCI6MTU5ODg3ODk4NCwiZXhwIjoxNjMwNDM2NTg0fQ.9HJFH_BS87Dnst8qmXhNSpgdrgOfXJzcOav0ox1E8A8","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\": \"newuser@gmail.com\",\r\n \"password\": \"1234567\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:5001/api/v1/auth/login"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"273"},{"key":"ETag","value":"W/\"111-e25m4VeCr/T8OFHoQNaPvWuwo2o\""},{"key":"Date","value":"Mon, 31 Aug 2020 16:03:19 GMT"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"You have successfully logged in on welcome..\",\n \"token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI1ZjRkMWRhNjFkNmJkZTcyOWNhMzk3ZDQiLCJhcHBfbmFtZSI6IndlbGNvbWUiLCJpYXQiOjE1OTg4ODk3OTksImV4cCI6MTU5ODk3NjE5OX0.v4pApSdSglOUmR2XM3SPMQOA96nBv7owCsXNAtjN7dM\"\n}"}],"_postman_id":"c6bece6d-befe-40ac-adb8-3cf9ecf6119b"},{"name":"Forgot Password Request","id":"4181cedc-61f4-4abe-8980-d742d6705e69","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer yourAppToken","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\": \"elikdev06@gmail.com\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:5001/api/v1/auth/forgot-password","description":"Users of application can request for password reset link
\n","urlObject":{"protocol":"http","port":"5001","path":["api","v1","auth","forgot-password"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"b35c7511-0e90-4f7e-8b7e-a37f2b459390","name":"Forgot Password Request","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhcHBfbmFtZSI6IndlbGNvbWUiLCJ1bmlxdWVfaWQiOiJlbWFpbCIsIm9yZ19uYW1lIjoia29saWVsaTEyMyIsImlhdCI6MTU5ODg3ODk4NCwiZXhwIjoxNjMwNDM2NTg0fQ.9HJFH_BS87Dnst8qmXhNSpgdrgOfXJzcOav0ox1E8A8","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\": \"useremail@gmail.com\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:5001/api/v1/auth/forgot-password"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"117"},{"key":"ETag","value":"W/\"75-bnWlzKVLr2rhf6wBgamYFZJlBf0\""},{"key":"Date","value":"Mon, 31 Aug 2020 16:06:53 GMT"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"A password reset link has been sent to your email. You would get it if you had entered a correct email.\"\n}"}],"_postman_id":"4181cedc-61f4-4abe-8980-d742d6705e69"},{"name":"Reset Password Request","id":"a455253e-0469-49c6-b948-811318080da8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"Authorization","value":"Bearer yourAppToken","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"newPassword\": \"2345678\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:5001/api/v1/auth/password-reset?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI1ZjRkMWRhNjFkNmJkZTcyOWNhMzk3ZDQiLCJpYXQiOjE1OTg4ODk5NjMsImV4cCI6MTU5ODk3NjM2M30.AsC0lzWAF-LyZrRNGL-MbC346BVPIM3dPeIm34Q9yg0","description":"This request handles this the password reset link that was sent to the application's user
\n","urlObject":{"protocol":"http","port":"5001","path":["api","v1","auth","password-reset"],"host":["localhost"],"query":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI1ZjRkMWRhNjFkNmJkZTcyOWNhMzk3ZDQiLCJpYXQiOjE1OTg4ODk5NjMsImV4cCI6MTU5ODk3NjM2M30.AsC0lzWAF-LyZrRNGL-MbC346BVPIM3dPeIm34Q9yg0"}],"variable":[]}},"response":[{"id":"39e9c89f-4a36-4be4-b1ee-1f081c608e04","name":"Reset Password Request","originalRequest":{"method":"PATCH","header":[{"key":"Authorization","value":"Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhcHBfbmFtZSI6IndlbGNvbWUiLCJ1bmlxdWVfaWQiOiJlbWFpbCIsIm9yZ19uYW1lIjoia29saWVsaTEyMyIsImlhdCI6MTU5ODg3ODk4NCwiZXhwIjoxNjMwNDM2NTg0fQ.9HJFH_BS87Dnst8qmXhNSpgdrgOfXJzcOav0ox1E8A8","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"newPassword\": \"2345678\"\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"http://localhost:5001/api/v1/auth/password-reset?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI1ZjRkMWRhNjFkNmJkZTcyOWNhMzk3ZDQiLCJpYXQiOjE1OTg4ODk5NjMsImV4cCI6MTU5ODk3NjM2M30.AsC0lzWAF-LyZrRNGL-MbC346BVPIM3dPeIm34Q9yg0","protocol":"http","host":["localhost"],"port":"5001","path":["api","v1","auth","password-reset"],"query":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI1ZjRkMWRhNjFkNmJkZTcyOWNhMzk3ZDQiLCJpYXQiOjE1OTg4ODk5NjMsImV4cCI6MTU5ODk3NjM2M30.AsC0lzWAF-LyZrRNGL-MbC346BVPIM3dPeIm34Q9yg0"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"73"},{"key":"ETag","value":"W/\"49-i15hMDfr2p0tEge3o+HqX7fYCz8\""},{"key":"Date","value":"Mon, 31 Aug 2020 16:08:49 GMT"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Your password has been updated on welcome. Proceed to login\"\n}"}],"_postman_id":"a455253e-0469-49c6-b948-811318080da8"},{"name":"Change Password Request","id":"f15d12aa-8990-4a74-9564-b56a8dcb596d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"access-token","value":"Bearer token","type":"text"},{"key":"Authorization","value":"Bearer yourAppToken","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"oldPassword\": \"2345678\",\r\n \"newPassword\": \"12345678\",\r\n \"confirmPassword\": \"12345678\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:5001/api/v1/auth/change-password","description":"A logged in user can decide that he wants to change his password
\n","urlObject":{"protocol":"http","port":"5001","path":["api","v1","auth","change-password"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"3ae2fd5a-529f-4b77-9313-5df0d8198f66","name":"Change Password Request","originalRequest":{"method":"POST","header":[{"key":"access-token","value":"Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI1ZjRkMWRhNjFkNmJkZTcyOWNhMzk3ZDQiLCJhcHBfbmFtZSI6IndlbGNvbWUiLCJpYXQiOjE1OTg4ODk3OTksImV4cCI6MTU5ODk3NjE5OX0.v4pApSdSglOUmR2XM3SPMQOA96nBv7owCsXNAtjN7dM","type":"text"},{"key":"Authorization","value":"Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhcHBfbmFtZSI6IndlbGNvbWUiLCJ1bmlxdWVfaWQiOiJlbWFpbCIsIm9yZ19uYW1lIjoia29saWVsaTEyMyIsImlhdCI6MTU5ODg3ODk4NCwiZXhwIjoxNjMwNDM2NTg0fQ.9HJFH_BS87Dnst8qmXhNSpgdrgOfXJzcOav0ox1E8A8","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"oldPassword\": \"2345678\",\r\n \"newPassword\": \"12345678\",\r\n \"confirmPassword\": \"12345678\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:5001/api/v1/auth/change-password"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"48"},{"key":"ETag","value":"W/\"30-ICLL21kbxtCnqZV9yZCdGAp38ag\""},{"key":"Date","value":"Mon, 31 Aug 2020 16:17:56 GMT"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Your password updated successfully\"\n}"}],"_postman_id":"f15d12aa-8990-4a74-9564-b56a8dcb596d"},{"name":"Token Verification Request","id":"15653e6d-bff2-4bec-ae21-8bbc3c4be9b9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer yourAppToken","type":"text"},{"key":"access-token","value":"Bearer token","type":"text"}],"url":"http://localhost:5001/api/v1/auth/verification","description":"Application may want to check for the validity of the token generated when a user logs in. Application may want to perform the check so as to restrict access of the users.
\n","urlObject":{"protocol":"http","port":"5001","path":["api","v1","auth","verification"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"f85ba48a-15fd-4d60-8f57-c4fd5fb65f16","name":"Token Verification Request","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhcHBfbmFtZSI6IndlbGNvbWUiLCJ1bmlxdWVfaWQiOiJlbWFpbCIsIm9yZ19uYW1lIjoia29saWVsaTEyMyIsImlhdCI6MTU5ODg3ODk4NCwiZXhwIjoxNjMwNDM2NTg0fQ.9HJFH_BS87Dnst8qmXhNSpgdrgOfXJzcOav0ox1E8A8","type":"text"},{"key":"access-token","value":"Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI1ZjRkMWRhNjFkNmJkZTcyOWNhMzk3ZDQiLCJhcHBfbmFtZSI6IndlbGNvbWUiLCJpYXQiOjE1OTg4ODk3OTksImV4cCI6MTU5ODk3NjE5OX0.v4pApSdSglOUmR2XM3SPMQOA96nBv7owCsXNAtjN7dM","type":"text"}],"url":"http://localhost:5001/api/v1/auth/verification"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"20"},{"key":"ETag","value":"W/\"14-ZEy4BARBB1yAlCWGOHiD5i9G3zk\""},{"key":"Date","value":"Mon, 31 Aug 2020 16:40:51 GMT"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"valid_token\": true\n}"}],"_postman_id":"15653e6d-bff2-4bec-ae21-8bbc3c4be9b9"}],"event":[{"listen":"prerequest","script":{"id":"fc853b24-ead3-4fcc-9d64-ffdd300d4bd3","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"cd77727d-f86a-4fab-87cb-ec73e00540ed","type":"text/javascript","exec":[""]}}]}