From d48b270bf5752e2a62a7746afce30651496a9419 Mon Sep 17 00:00:00 2001 From: Revant Nandgaonkar Date: Tue, 25 Oct 2016 10:28:32 +0530 Subject: [PATCH] OAuth 2 Provider for frappe (#2167) * OAuth 2.0 Classes Added Added oauthlib in requirement.txt Added class WebApplicationServer for Authorization code grant and Bearer tokens. Added class OAuthWebRequestValidator for Validating Oauth Request for Web Application * copied code from mnt_oauth needs review * [New] OAuth2 Doctypes and endpoints added Integrations > OAuth Provider Settings Integration Broker > OAuth Bearer Token Integration Broker > OAuth Authorization Code Integration Broker > OAuth Client endpoints for authorize, approve, get_token, revoke_token and test_resource * oauth2.py: renamed skipauth to skip_auth * [Fix] Parse URL instead of storing it in settings * [Fix] get skip_auth from OAuth Provider Settings * Success URL format. Failure URL added. Confirmation dialog layout changed. * Validate access token if passed during use of REST API * OAuth Confirmation colours fixed * Multiple Changes Added links for OAuth under Integrations in Module list. Updated permissions on OAuth doctypes. Updated layout of OAuth Client doctype. * [Docs] Integrations > How to setup OAuth * [Docs] Integration > Using OAuth * [Fix] get_token endpoint must to handle POST request * [Fix] http verbs and responses for OAuth 2.0 Endpoints * [Fix] accept oauth2 access_token from headers * Removed unused imports from api.py --- frappe/api.py | 24 + frappe/config/setup.py | 12 +- frappe/docs/assets/img/oauth2_client_app.png | Bin 0 -> 86642 bytes .../assets/img/oauth_confirmation_page.png | Bin 0 -> 34412 bytes .../assets/img/oauth_provider_settings.png | Bin 0 -> 46477 bytes .../guides/integration/how_to_setup_oauth.md | 47 ++ .../docs/user/en/guides/integration/index.txt | 2 + .../user/en/guides/integration/using_oauth.md | 109 +++++ .../oauth_authorization_code/__init__.py | 0 .../oauth_authorization_code.js | 8 + .../oauth_authorization_code.json | 241 ++++++++++ .../oauth_authorization_code.py | 10 + .../test_oauth_authorization_code.py | 12 + .../doctype/oauth_bearer_token/__init__.py | 0 .../oauth_bearer_token/oauth_bearer_token.js | 8 + .../oauth_bearer_token.json | 266 +++++++++++ .../oauth_bearer_token/oauth_bearer_token.py | 13 + .../test_oauth_bearer_token.py | 12 + .../doctype/oauth_client/__init__.py | 0 .../doctype/oauth_client/oauth_client.js | 8 + .../doctype/oauth_client/oauth_client.json | 428 ++++++++++++++++++ .../doctype/oauth_client/oauth_client.py | 11 + .../doctype/oauth_client/test_oauth_client.py | 12 + frappe/integration_broker/oauth2.py | 123 +++++ .../oauth_provider_settings/__init__.py | 0 .../oauth_provider_settings.js | 8 + .../oauth_provider_settings.json | 87 ++++ .../oauth_provider_settings.py | 19 + frappe/oauth.py | 282 ++++++++++++ .../includes/oauth_confirmation.html | 47 ++ requirements.txt | 1 + 31 files changed, 1789 insertions(+), 1 deletion(-) create mode 100644 frappe/docs/assets/img/oauth2_client_app.png create mode 100644 frappe/docs/assets/img/oauth_confirmation_page.png create mode 100644 frappe/docs/assets/img/oauth_provider_settings.png create mode 100644 frappe/docs/user/en/guides/integration/how_to_setup_oauth.md create mode 100644 frappe/docs/user/en/guides/integration/using_oauth.md create mode 100644 frappe/integration_broker/doctype/oauth_authorization_code/__init__.py create mode 100644 frappe/integration_broker/doctype/oauth_authorization_code/oauth_authorization_code.js create mode 100644 frappe/integration_broker/doctype/oauth_authorization_code/oauth_authorization_code.json create mode 100644 frappe/integration_broker/doctype/oauth_authorization_code/oauth_authorization_code.py create mode 100644 frappe/integration_broker/doctype/oauth_authorization_code/test_oauth_authorization_code.py create mode 100644 frappe/integration_broker/doctype/oauth_bearer_token/__init__.py create mode 100644 frappe/integration_broker/doctype/oauth_bearer_token/oauth_bearer_token.js create mode 100644 frappe/integration_broker/doctype/oauth_bearer_token/oauth_bearer_token.json create mode 100644 frappe/integration_broker/doctype/oauth_bearer_token/oauth_bearer_token.py create mode 100644 frappe/integration_broker/doctype/oauth_bearer_token/test_oauth_bearer_token.py create mode 100644 frappe/integration_broker/doctype/oauth_client/__init__.py create mode 100644 frappe/integration_broker/doctype/oauth_client/oauth_client.js create mode 100644 frappe/integration_broker/doctype/oauth_client/oauth_client.json create mode 100644 frappe/integration_broker/doctype/oauth_client/oauth_client.py create mode 100644 frappe/integration_broker/doctype/oauth_client/test_oauth_client.py create mode 100644 frappe/integration_broker/oauth2.py create mode 100644 frappe/integrations/doctype/oauth_provider_settings/__init__.py create mode 100644 frappe/integrations/doctype/oauth_provider_settings/oauth_provider_settings.js create mode 100644 frappe/integrations/doctype/oauth_provider_settings/oauth_provider_settings.json create mode 100644 frappe/integrations/doctype/oauth_provider_settings/oauth_provider_settings.py create mode 100644 frappe/oauth.py create mode 100644 frappe/templates/includes/oauth_confirmation.html diff --git a/frappe/api.py b/frappe/api.py index 99bc996f55..0092067ffb 100644 --- a/frappe/api.py +++ b/frappe/api.py @@ -8,6 +8,9 @@ import frappe.handler import frappe.client from frappe.utils.response import build_response from frappe import _ +from urlparse import urlparse +from urllib import urlencode +from frappe.integration_broker.oauth2 import oauth_server def handle(): """ @@ -32,6 +35,27 @@ def handle(): `/api/resource/{doctype}/{name}?run_method={method}` will run a whitelisted controller method """ + + form_dict = frappe.local.form_dict + authorization_header = frappe.get_request_header("Authorization").split(" ") if frappe.get_request_header("Authorization") else None + if authorization_header and authorization_header[0].lower() == "bearer": + token = authorization_header[1] + r = frappe.request + parsed_url = urlparse(r.url) + access_token = { "access_token": token} + uri = parsed_url.scheme + "://" + parsed_url.netloc + parsed_url.path + "?" + urlencode(access_token) + http_method = r.method + body = r.get_data() + headers = r.headers + + required_scopes = frappe.db.get_value("OAuth Bearer Token", token, "scopes").split(";") + + valid, oauthlib_request = oauth_server.verify_request(uri, http_method, body, headers, required_scopes) + + if valid: + frappe.set_user(frappe.db.get_value("OAuth Bearer Token", token, "user")) + frappe.local.form_dict = form_dict + parts = frappe.request.path[1:].split("/",3) call = doctype = name = None diff --git a/frappe/config/setup.py b/frappe/config/setup.py index 91cba064df..07b96ea85f 100644 --- a/frappe/config/setup.py +++ b/frappe/config/setup.py @@ -224,7 +224,17 @@ def get_data(): "type": "doctype", "name": "Integration Service", "description": _("Centralize access to Integrations"), - } + }, + { + "type": "doctype", + "name": "OAuth Client", + "description": _("Register OAuth Client App"), + }, + { + "type": "doctype", + "name": "OAuth Provider Settings", + "description": _("Settings for OAuth Provider"), + }, ] }, { diff --git a/frappe/docs/assets/img/oauth2_client_app.png b/frappe/docs/assets/img/oauth2_client_app.png new file mode 100644 index 0000000000000000000000000000000000000000..6b0d90500bee68341c7b8c98fd0c4f152f2cd41c GIT binary patch literal 86642 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 nzkuBj*Hi@|+l*0Z}J-n)AU!j25oPP<5uHX$Qg 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 literal 0 HcmV?d00001 diff --git a/frappe/docs/user/en/guides/integration/how_to_setup_oauth.md b/frappe/docs/user/en/guides/integration/how_to_setup_oauth.md new file mode 100644 index 0000000000..7a1d615cfe --- /dev/null +++ b/frappe/docs/user/en/guides/integration/how_to_setup_oauth.md @@ -0,0 +1,47 @@ +# How to setup oauth? + +OAuth 2.0 provider based on oauthlib is built into frappe. Third party apps can now access resources of users based on Frappe Role and User permission system. To setup an app to access + +## OAuth defines four roles + +#### resource owner +An entity capable of granting access to a protected resource. When the resource owner is a person, it is referred to as an end-user. + +#### resource server +The server hosting the protected resources, capable of accepting and responding to protected resource requests using access tokens. + +#### client +An application making protected resource requests on behalf of the resource owner and with its authorization. The term "client" does not imply any particular implementation characteristics (e.g., +whether the application executes on a server, a desktop, or other devices). + +#### authorization server +The server issuing access tokens to the client after successfully authenticating the resource owner and obtaining authorization. + +## Setup OAuth Provider + +System Managers can setup behavior of confirmation message as `Force` or `Auto` in OAuth Provider Settings. +If Force is selected the system will always ask for user's confirmation. If Auto is selected system asks for the confirmation only if there are no active tokens for the user. + +Go to + +> Setup > Integrations > OAuth Provider Settings + + + +## Add a Client App + +As a System Manager go to + +> Setup > Integrations > OAuth Client + + + +To add a client fill in the following details + +1. **App Name** : Enter App Name e.g. CAVS +2. **Skip Authorization** : If this is checked, during authentication there won't be me any confirmation message +3. **Scopes** : List of scopes shown to user along with confirmation message. scopes are separated by semicolon ';' +4. **Redirect URIs** : List of Redirect URIs separated by semicolon ';' +5. **Default Redirect URIs** : Default Redirect URI from list of Redirect URIs +6. **Grant Type**: select `Authorization Code` +7. **Response Type**: select `Code` diff --git a/frappe/docs/user/en/guides/integration/index.txt b/frappe/docs/user/en/guides/integration/index.txt index 8f8d276e69..6bee5d8835 100755 --- a/frappe/docs/user/en/guides/integration/index.txt +++ b/frappe/docs/user/en/guides/integration/index.txt @@ -1 +1,3 @@ rest_api +how_to_setup_oauth +using_oauth diff --git a/frappe/docs/user/en/guides/integration/using_oauth.md b/frappe/docs/user/en/guides/integration/using_oauth.md new file mode 100644 index 0000000000..1a6f694574 --- /dev/null +++ b/frappe/docs/user/en/guides/integration/using_oauth.md @@ -0,0 +1,109 @@ +# Using OAuth + +Once the client and provider settings are entered, following steps can be used to start using OAuth 2.0 + +### Authorization Code Endpoint + +#### Authorization Request + +URL: +``` +[GET] 0.0.0.0:8000/api/method/frappe.integration_broker.oauth2.authorize +``` +Params: +``` +client_id = +scope = +response_type = "code" +redirect_uri = +``` + +#### Confirmation Dialog + + + +Click 'Allow' to receive authorization code in redirect uri. + +``` +http://localhost:3000/oauth_code?code=plkj2mqDLwaLJAgDBAkyR1W8Co08Ud +``` +If user clicks 'Deny' receive error +``` +http://localhost:3000/oauth_code?error=access_denied +``` + +### Token Endpoints + +#### Get Access Token + +URL: +``` +[POST] 0.0.0.0:8000/api/method/frappe.integration_broker.oauth2.get_token +``` +Params: +``` +grant_type = "authorization_code" +code = +redirect_uri = +client_id = +``` +Response: +``` +{ + "access_token": "pNO2DpTMHTcFHYUXwzs74k6idQBmnI", + "token_type": "Bearer", + "expires_in": 3600, + "refresh_token": "cp74cxbbDgaxFuUZ8Usc7egYlhKbH1", + "scope": "project" +} +``` + +#### Refresh Access Token + +URL: +``` +[POST] 0.0.0.0:8000/api/method/frappe.integration_broker.oauth2.get_token +``` +Params: +``` +grant_type = "refresh_token" +refresh_token = +redirect_uri = +client_id = +``` +Response: +``` +{ + "access_token": "Ywz1iNk0b21iAmjWAYnFWT4CuudHD5", + "token_type": "Bearer", + "expires_in": 3600, + "refresh_token": "PNux3Q8Citr3s9rl2zEsKuU1l8bSN5", + "scope": "project" +} +``` +#### Revoke Token Endpoint + +URL: +``` +[POST] 0.0.0.0:8000/api/method/frappe.integration_broker.oauth2.revoke_token +``` +Params: +``` +token = +``` +Success Response +``` +status : 200 + +{"message": "success"} +``` +Error Response: +``` +status : 400 + +{"message": "bad request"} +``` + +### Accessing Resource + +Add header `Authorizaton: Bearer ` to Frappe's REST API endpoints to access user's resource diff --git a/frappe/integration_broker/doctype/oauth_authorization_code/__init__.py b/frappe/integration_broker/doctype/oauth_authorization_code/__init__.py new file mode 100644 index 0000000000..e69de29bb2 diff --git a/frappe/integration_broker/doctype/oauth_authorization_code/oauth_authorization_code.js b/frappe/integration_broker/doctype/oauth_authorization_code/oauth_authorization_code.js new file mode 100644 index 0000000000..32746e6752 --- /dev/null +++ b/frappe/integration_broker/doctype/oauth_authorization_code/oauth_authorization_code.js @@ -0,0 +1,8 @@ +// Copyright (c) 2016, Frappe Technologies and contributors +// For license information, please see license.txt + +frappe.ui.form.on('OAuth Authorization Code', { + refresh: function(frm) { + + } +}); diff --git a/frappe/integration_broker/doctype/oauth_authorization_code/oauth_authorization_code.json b/frappe/integration_broker/doctype/oauth_authorization_code/oauth_authorization_code.json new file mode 100644 index 0000000000..35ee594063 --- /dev/null +++ b/frappe/integration_broker/doctype/oauth_authorization_code/oauth_authorization_code.json @@ -0,0 +1,241 @@ +{ + "allow_copy": 0, + "allow_import": 0, + "allow_rename": 0, + "autoname": "field:authorization_code", + "beta": 0, + "creation": "2016-08-24 14:12:13.647159", + "custom": 0, + "docstatus": 0, + "doctype": "DocType", + "document_type": "Document", + "editable_grid": 1, + "engine": "InnoDB", + "fields": [ + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "fieldname": "client", + "fieldtype": "Link", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 1, + "label": "Client", + "length": 0, + "no_copy": 0, + "options": "OAuth Client", + "permlevel": 0, + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 0, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + }, + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "fieldname": "user", + "fieldtype": "Link", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 0, + "label": "User", + "length": 0, + "no_copy": 0, + "options": "User", + "permlevel": 0, + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 0, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + }, + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "fieldname": "scopes", + "fieldtype": "Text", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 0, + "label": "Scopes", + "length": 0, + "no_copy": 0, + "permlevel": 0, + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 0, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + }, + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "fieldname": "authorization_code", + "fieldtype": "Text", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 1, + "label": "Authorization Code", + "length": 0, + "no_copy": 0, + "permlevel": 0, + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 0, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + }, + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "fieldname": "expiration_time", + "fieldtype": "Datetime", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 0, + "label": "Expiration time", + "length": 0, + "no_copy": 0, + "permlevel": 0, + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 0, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + }, + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "fieldname": "redirect_uri_bound_to_authorization_code", + "fieldtype": "Data", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 0, + "label": "Redirect URI Bound To Auth Code", + "length": 0, + "no_copy": 0, + "permlevel": 0, + "precision": "", + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 0, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + }, + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "fieldname": "validity", + "fieldtype": "Select", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 1, + "label": "Validity", + "length": 0, + "no_copy": 0, + "options": "Valid\nInvalid", + "permlevel": 0, + "precision": "", + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 0, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + } + ], + "hide_heading": 0, + "hide_toolbar": 0, + "idx": 0, + "image_view": 0, + "in_create": 0, + "in_dialog": 0, + "is_submittable": 0, + "issingle": 0, + "istable": 0, + "max_attachments": 0, + "modified": "2016-10-20 00:13:53.224437", + "modified_by": "Administrator", + "module": "Integration Broker", + "name": "OAuth Authorization Code", + "name_case": "", + "owner": "Administrator", + "permissions": [ + { + "amend": 0, + "apply_user_permissions": 0, + "cancel": 0, + "create": 1, + "delete": 1, + "email": 1, + "export": 1, + "if_owner": 0, + "import": 0, + "is_custom": 0, + "permlevel": 0, + "print": 1, + "read": 1, + "report": 1, + "role": "System Manager", + "set_user_permissions": 0, + "share": 1, + "submit": 0, + "write": 1 + } + ], + "quick_entry": 0, + "read_only": 0, + "read_only_onload": 0, + "sort_field": "modified", + "sort_order": "DESC", + "track_seen": 0 +} \ No newline at end of file diff --git a/frappe/integration_broker/doctype/oauth_authorization_code/oauth_authorization_code.py b/frappe/integration_broker/doctype/oauth_authorization_code/oauth_authorization_code.py new file mode 100644 index 0000000000..f08e7eb5bb --- /dev/null +++ b/frappe/integration_broker/doctype/oauth_authorization_code/oauth_authorization_code.py @@ -0,0 +1,10 @@ +# -*- coding: utf-8 -*- +# Copyright (c) 2015, Frappe Technologies and contributors +# For license information, please see license.txt + +from __future__ import unicode_literals +import frappe +from frappe.model.document import Document + +class OAuthAuthorizationCode(Document): + pass diff --git a/frappe/integration_broker/doctype/oauth_authorization_code/test_oauth_authorization_code.py b/frappe/integration_broker/doctype/oauth_authorization_code/test_oauth_authorization_code.py new file mode 100644 index 0000000000..cecf187e61 --- /dev/null +++ b/frappe/integration_broker/doctype/oauth_authorization_code/test_oauth_authorization_code.py @@ -0,0 +1,12 @@ +# -*- coding: utf-8 -*- +# Copyright (c) 2015, Frappe Technologies and Contributors +# See license.txt +from __future__ import unicode_literals + +import frappe +import unittest + +# test_records = frappe.get_test_records('OAuth Authorization Code') + +class TestOAuthAuthorizationCode(unittest.TestCase): + pass diff --git a/frappe/integration_broker/doctype/oauth_bearer_token/__init__.py b/frappe/integration_broker/doctype/oauth_bearer_token/__init__.py new file mode 100644 index 0000000000..e69de29bb2 diff --git a/frappe/integration_broker/doctype/oauth_bearer_token/oauth_bearer_token.js b/frappe/integration_broker/doctype/oauth_bearer_token/oauth_bearer_token.js new file mode 100644 index 0000000000..da69753903 --- /dev/null +++ b/frappe/integration_broker/doctype/oauth_bearer_token/oauth_bearer_token.js @@ -0,0 +1,8 @@ +// Copyright (c) 2016, Frappe Technologies and contributors +// For license information, please see license.txt + +frappe.ui.form.on('OAuth Bearer Token', { + refresh: function(frm) { + + } +}); diff --git a/frappe/integration_broker/doctype/oauth_bearer_token/oauth_bearer_token.json b/frappe/integration_broker/doctype/oauth_bearer_token/oauth_bearer_token.json new file mode 100644 index 0000000000..029b8754fe --- /dev/null +++ b/frappe/integration_broker/doctype/oauth_bearer_token/oauth_bearer_token.json @@ -0,0 +1,266 @@ +{ + "allow_copy": 0, + "allow_import": 0, + "allow_rename": 0, + "autoname": "field:access_token", + "beta": 0, + "creation": "2016-08-24 14:10:17.471264", + "custom": 0, + "docstatus": 0, + "doctype": "DocType", + "document_type": "Document", + "editable_grid": 1, + "engine": "InnoDB", + "fields": [ + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "fieldname": "client", + "fieldtype": "Link", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 1, + "label": "Client", + "length": 0, + "no_copy": 0, + "options": "OAuth Client", + "permlevel": 0, + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 0, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + }, + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "fieldname": "user", + "fieldtype": "Link", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 0, + "label": "User", + "length": 0, + "no_copy": 0, + "options": "User", + "permlevel": 0, + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 0, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + }, + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "fieldname": "scopes", + "fieldtype": "Text", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 0, + "label": "Scopes", + "length": 0, + "no_copy": 0, + "permlevel": 0, + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 0, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + }, + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "fieldname": "access_token", + "fieldtype": "Data", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 0, + "label": "Access Token", + "length": 0, + "no_copy": 0, + "permlevel": 0, + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 0, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + }, + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "fieldname": "refresh_token", + "fieldtype": "Data", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 0, + "label": "Refresh Token", + "length": 0, + "no_copy": 0, + "permlevel": 0, + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 0, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + }, + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "fieldname": "expiration_time", + "fieldtype": "Datetime", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 0, + "label": "Expiration time", + "length": 0, + "no_copy": 0, + "permlevel": 0, + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 0, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + }, + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "fieldname": "expires_in", + "fieldtype": "Int", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 0, + "label": "Expires In", + "length": 0, + "no_copy": 0, + "permlevel": 0, + "precision": "", + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 0, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + }, + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "fieldname": "status", + "fieldtype": "Select", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 0, + "label": "Status", + "length": 0, + "no_copy": 0, + "options": "Active\nRevoked", + "permlevel": 0, + "precision": "", + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 0, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + } + ], + "hide_heading": 0, + "hide_toolbar": 0, + "idx": 0, + "image_view": 0, + "in_create": 0, + "in_dialog": 0, + "is_submittable": 0, + "issingle": 0, + "istable": 0, + "max_attachments": 0, + "modified": "2016-10-20 00:13:41.747141", + "modified_by": "Administrator", + "module": "Integration Broker", + "name": "OAuth Bearer Token", + "name_case": "", + "owner": "Administrator", + "permissions": [ + { + "amend": 0, + "apply_user_permissions": 0, + "cancel": 0, + "create": 1, + "delete": 1, + "email": 1, + "export": 1, + "if_owner": 0, + "import": 0, + "is_custom": 0, + "permlevel": 0, + "print": 1, + "read": 1, + "report": 1, + "role": "System Manager", + "set_user_permissions": 0, + "share": 1, + "submit": 0, + "write": 1 + } + ], + "quick_entry": 0, + "read_only": 0, + "read_only_onload": 0, + "sort_field": "modified", + "sort_order": "DESC", + "track_seen": 0 +} \ No newline at end of file diff --git a/frappe/integration_broker/doctype/oauth_bearer_token/oauth_bearer_token.py b/frappe/integration_broker/doctype/oauth_bearer_token/oauth_bearer_token.py new file mode 100644 index 0000000000..1c7e921140 --- /dev/null +++ b/frappe/integration_broker/doctype/oauth_bearer_token/oauth_bearer_token.py @@ -0,0 +1,13 @@ +# -*- coding: utf-8 -*- +# Copyright (c) 2015, Frappe Technologies and contributors +# For license information, please see license.txt + +from __future__ import unicode_literals +import frappe +from frappe.model.document import Document + +class OAuthBearerToken(Document): + def validate(self): + if not self.expiration_time: + self.expiration_time = frappe.utils.datetime.datetime.strptime(self.creation, "%Y-%m-%d %H:%M:%S.%f") + frappe.utils.datetime.timedelta(seconds=self.expires_in) + diff --git a/frappe/integration_broker/doctype/oauth_bearer_token/test_oauth_bearer_token.py b/frappe/integration_broker/doctype/oauth_bearer_token/test_oauth_bearer_token.py new file mode 100644 index 0000000000..af7de360ab --- /dev/null +++ b/frappe/integration_broker/doctype/oauth_bearer_token/test_oauth_bearer_token.py @@ -0,0 +1,12 @@ +# -*- coding: utf-8 -*- +# Copyright (c) 2015, Frappe Technologies and Contributors +# See license.txt +from __future__ import unicode_literals + +import frappe +import unittest + +# test_records = frappe.get_test_records('OAuth Bearer Token') + +class TestOAuthBearerToken(unittest.TestCase): + pass diff --git a/frappe/integration_broker/doctype/oauth_client/__init__.py b/frappe/integration_broker/doctype/oauth_client/__init__.py new file mode 100644 index 0000000000..e69de29bb2 diff --git a/frappe/integration_broker/doctype/oauth_client/oauth_client.js b/frappe/integration_broker/doctype/oauth_client/oauth_client.js new file mode 100644 index 0000000000..b0caa562b1 --- /dev/null +++ b/frappe/integration_broker/doctype/oauth_client/oauth_client.js @@ -0,0 +1,8 @@ +// Copyright (c) 2016, Frappe Technologies and contributors +// For license information, please see license.txt + +frappe.ui.form.on('OAuth Client', { + refresh: function(frm) { + + } +}); diff --git a/frappe/integration_broker/doctype/oauth_client/oauth_client.json b/frappe/integration_broker/doctype/oauth_client/oauth_client.json new file mode 100644 index 0000000000..83ec6bebdd --- /dev/null +++ b/frappe/integration_broker/doctype/oauth_client/oauth_client.json @@ -0,0 +1,428 @@ +{ + "allow_copy": 0, + "allow_import": 0, + "allow_rename": 0, + "autoname": "", + "beta": 0, + "creation": "2016-08-24 14:07:21.955052", + "custom": 0, + "docstatus": 0, + "doctype": "DocType", + "document_type": "Document", + "editable_grid": 1, + "engine": "InnoDB", + "fields": [ + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "fieldname": "app_name", + "fieldtype": "Data", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 0, + "label": "App Name", + "length": 0, + "no_copy": 0, + "permlevel": 0, + "precision": "", + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 1, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + }, + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "fieldname": "user", + "fieldtype": "Link", + "hidden": 1, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 0, + "label": "User", + "length": 0, + "no_copy": 0, + "options": "User", + "permlevel": 0, + "precision": "", + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 0, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + }, + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "fieldname": "cb_1", + "fieldtype": "Column Break", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 0, + "length": 0, + "no_copy": 0, + "permlevel": 0, + "precision": "", + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 0, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + }, + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "default": "", + "fieldname": "client_id", + "fieldtype": "Data", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 0, + "label": "App Client ID", + "length": 0, + "no_copy": 0, + "permlevel": 0, + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 1, + "report_hide": 0, + "reqd": 0, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + }, + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "description": "If checked, users will not see the Confirm Access dialog.", + "fieldname": "skip_authorization", + "fieldtype": "Check", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 0, + "label": "Skip Authorization", + "length": 0, + "no_copy": 0, + "permlevel": 0, + "precision": "", + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 0, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + }, + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "description": "", + "fieldname": "sb_1", + "fieldtype": "Section Break", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 0, + "label": "", + "length": 0, + "no_copy": 0, + "permlevel": 0, + "precision": "", + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 0, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + }, + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "description": "A list of resources which the Client App will have access to after the user allows it.
e.g. project", + "fieldname": "scopes", + "fieldtype": "Text", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 0, + "label": "Scopes", + "length": 0, + "no_copy": 0, + "permlevel": 0, + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 1, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + }, + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "fieldname": "cb_3", + "fieldtype": "Column Break", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 0, + "length": 0, + "no_copy": 0, + "permlevel": 0, + "precision": "", + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 0, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + }, + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "description": "URIs for receiving authorization code once the user allows access, as well as failure responses. Typically a REST endpoint exposed by the Client App.\n
e.g. http://hostname//api/method/frappe.www.login.login_via_facebook", + "fieldname": "redirect_uris", + "fieldtype": "Text", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 0, + "label": "Redirect URIs", + "length": 0, + "no_copy": 0, + "permlevel": 0, + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 0, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + }, + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "fieldname": "default_redirect_uri", + "fieldtype": "Data", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 0, + "label": "Default Redirect URI", + "length": 0, + "no_copy": 0, + "permlevel": 0, + "precision": "", + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 1, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + }, + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 1, + "collapsible_depends_on": "1", + "columns": 0, + "fieldname": "sb_advanced", + "fieldtype": "Section Break", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 0, + "label": " Advanced Settings", + "length": 0, + "no_copy": 0, + "permlevel": 0, + "precision": "", + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 0, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + }, + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "fieldname": "grant_type", + "fieldtype": "Select", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 1, + "label": "Grant Type", + "length": 0, + "no_copy": 0, + "options": "Authorization Code\nImplicit\nResource Owner Password Credentials\nClient Credentials", + "permlevel": 0, + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 0, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + }, + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "fieldname": "cb_2", + "fieldtype": "Column Break", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 0, + "length": 0, + "no_copy": 0, + "permlevel": 0, + "precision": "", + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 0, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + }, + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "default": "Code", + "fieldname": "response_type", + "fieldtype": "Select", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 1, + "label": "Response Type", + "length": 0, + "no_copy": 0, + "options": "Code\nToken", + "permlevel": 0, + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 0, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + } + ], + "hide_heading": 0, + "hide_toolbar": 0, + "idx": 0, + "image_view": 0, + "in_create": 0, + "in_dialog": 0, + "is_submittable": 0, + "issingle": 0, + "istable": 0, + "max_attachments": 0, + "modified": "2016-10-20 00:32:11.993940", + "modified_by": "Administrator", + "module": "Integration Broker", + "name": "OAuth Client", + "name_case": "", + "owner": "Administrator", + "permissions": [ + { + "amend": 0, + "apply_user_permissions": 0, + "cancel": 0, + "create": 1, + "delete": 1, + "email": 1, + "export": 1, + "if_owner": 0, + "import": 0, + "is_custom": 0, + "permlevel": 0, + "print": 1, + "read": 1, + "report": 1, + "role": "System Manager", + "set_user_permissions": 0, + "share": 1, + "submit": 0, + "write": 1 + } + ], + "quick_entry": 0, + "read_only": 0, + "read_only_onload": 0, + "sort_field": "modified", + "sort_order": "DESC", + "title_field": "app_name", + "track_seen": 0 +} \ No newline at end of file diff --git a/frappe/integration_broker/doctype/oauth_client/oauth_client.py b/frappe/integration_broker/doctype/oauth_client/oauth_client.py new file mode 100644 index 0000000000..3493832064 --- /dev/null +++ b/frappe/integration_broker/doctype/oauth_client/oauth_client.py @@ -0,0 +1,11 @@ +# -*- coding: utf-8 -*- +# Copyright (c) 2015, Frappe Technologies and contributors +# For license information, please see license.txt + +from __future__ import unicode_literals +import frappe +from frappe.model.document import Document + +class OAuthClient(Document): + def validate(self): + self.client_id = self.name diff --git a/frappe/integration_broker/doctype/oauth_client/test_oauth_client.py b/frappe/integration_broker/doctype/oauth_client/test_oauth_client.py new file mode 100644 index 0000000000..ee119455e5 --- /dev/null +++ b/frappe/integration_broker/doctype/oauth_client/test_oauth_client.py @@ -0,0 +1,12 @@ +# -*- coding: utf-8 -*- +# Copyright (c) 2015, Frappe Technologies and Contributors +# See license.txt +from __future__ import unicode_literals + +import frappe +import unittest + +# test_records = frappe.get_test_records('OAuth Client') + +class TestOAuthClient(unittest.TestCase): + pass diff --git a/frappe/integration_broker/oauth2.py b/frappe/integration_broker/oauth2.py new file mode 100644 index 0000000000..422b6c9d4e --- /dev/null +++ b/frappe/integration_broker/oauth2.py @@ -0,0 +1,123 @@ +from __future__ import unicode_literals +import frappe, json +from frappe.oauth import OAuthWebRequestValidator, WebApplicationServer +from oauthlib.oauth2 import FatalClientError, OAuth2Error +from urllib import quote, urlencode +from urlparse import urlparse +from frappe.integrations.doctype.oauth_provider_settings.oauth_provider_settings import get_oauth_settings + +#Variables required across requests +oauth_validator = OAuthWebRequestValidator() +oauth_server = WebApplicationServer(oauth_validator) +credentials = None + +def get_urlparams_from_kwargs(param_kwargs): + arguments = param_kwargs + if arguments.get("data"): + arguments.pop("data") + if arguments.get("cmd"): + arguments.pop("cmd") + + return urlencode(arguments) + +@frappe.whitelist() +def approve(*args, **kwargs): + r = frappe.request + uri = r.url + http_method = r.method + body = r.get_data() + headers = r.headers + + try: + scopes, credentials = oauth_server.validate_authorization_request(uri, http_method, body, headers) + + headers, body, status = oauth_server.create_authorization_response(uri=credentials['redirect_uri'], \ + body=body, headers=headers, scopes=scopes, credentials=credentials) + uri = headers.get('Location', None) + + frappe.local.response["type"] = "redirect" + frappe.local.response["location"] = uri + + except FatalClientError as e: + return e + except OAuth2Error as e: + return e + +@frappe.whitelist(allow_guest=True) +def authorize(*args, **kwargs): + #Fetch provider URL from settings + oauth_settings = get_oauth_settings() + params = get_urlparams_from_kwargs(kwargs) + request_url = urlparse(frappe.request.url) + success_url = request_url.scheme + "://" + request_url.netloc + "/api/method/frappe.integration_broker.oauth2.approve?" + params + failure_url = frappe.form_dict["redirect_uri"] + "?error=access_denied" + + if frappe.session['user']=='Guest': + #Force login, redirect to preauth again. + frappe.local.response["type"] = "redirect" + frappe.local.response["location"] = "/login?redirect-to=/api/method/frappe.integration_broker.oauth2.authorize?" + quote(params) + + elif frappe.session['user']!='Guest': + try: + r = frappe.request + uri = r.url + http_method = r.method + body = r.get_data() + headers = r.headers + + scopes, credentials = oauth_server.validate_authorization_request(uri, http_method, body, headers) + + skip_auth = frappe.db.get_value("OAuth Client", credentials['client_id'], "skip_authorization") + unrevoked_tokens = frappe.get_all("OAuth Bearer Token", filters={"status":"Active"}) + + if skip_auth or (oauth_settings["skip_authorization"] == "Auto" and len(unrevoked_tokens)): + + frappe.local.response["type"] = "redirect" + frappe.local.response["location"] = success_url + else: + #Show Allow/Deny screen. + response_html_params = frappe._dict({ + "client_id": frappe.db.get_value("OAuth Client", kwargs['client_id'], "app_name"), + "success_url": success_url, + "failure_url": failure_url, + "details": scopes + }) + resp_html = frappe.render_template("templates/includes/oauth_confirmation.html", response_html_params) + frappe.respond_as_web_page("Confirm Access", resp_html) + + except FatalClientError as e: + return e + except OAuth2Error as e: + return e + +@frappe.whitelist(allow_guest=True) +def get_token(*args, **kwargs): + r = frappe.request + + uri = r.url + http_method = r.method + body = r.form + headers = r.headers + + try: + headers, body, status = oauth_server.create_token_response(uri, http_method, body, headers, credentials) + frappe.local.response = frappe._dict(json.loads(body)) + except FatalClientError as e: + return e + + +@frappe.whitelist(allow_guest=True) +def revoke_token(*args, **kwargs): + r = frappe.request + uri = r.url + http_method = r.method + body = r.form + headers = r.headers + + headers, body, status = oauth_server.create_revocation_response(uri, headers=headers, body=body, http_method=http_method) + + frappe.local.response['http_status_code'] = status + if status == 200: + return "success" + else: + return "bad request" \ No newline at end of file diff --git a/frappe/integrations/doctype/oauth_provider_settings/__init__.py b/frappe/integrations/doctype/oauth_provider_settings/__init__.py new file mode 100644 index 0000000000..e69de29bb2 diff --git a/frappe/integrations/doctype/oauth_provider_settings/oauth_provider_settings.js b/frappe/integrations/doctype/oauth_provider_settings/oauth_provider_settings.js new file mode 100644 index 0000000000..6d7d071934 --- /dev/null +++ b/frappe/integrations/doctype/oauth_provider_settings/oauth_provider_settings.js @@ -0,0 +1,8 @@ +// Copyright (c) 2016, Frappe Technologies and contributors +// For license information, please see license.txt + +frappe.ui.form.on('OAuth Provider Settings', { + refresh: function(frm) { + + } +}); diff --git a/frappe/integrations/doctype/oauth_provider_settings/oauth_provider_settings.json b/frappe/integrations/doctype/oauth_provider_settings/oauth_provider_settings.json new file mode 100644 index 0000000000..b48c50a000 --- /dev/null +++ b/frappe/integrations/doctype/oauth_provider_settings/oauth_provider_settings.json @@ -0,0 +1,87 @@ +{ + "allow_copy": 0, + "allow_import": 0, + "allow_rename": 0, + "beta": 0, + "creation": "2016-09-03 11:42:42.575525", + "custom": 0, + "docstatus": 0, + "doctype": "DocType", + "document_type": "Setup", + "editable_grid": 1, + "engine": "InnoDB", + "fields": [ + { + "allow_on_submit": 0, + "bold": 0, + "collapsible": 0, + "columns": 0, + "fieldname": "skip_authorization", + "fieldtype": "Select", + "hidden": 0, + "ignore_user_permissions": 0, + "ignore_xss_filter": 0, + "in_filter": 0, + "in_list_view": 0, + "label": "Skip Authorization", + "length": 0, + "no_copy": 0, + "options": "Force\nAuto", + "permlevel": 0, + "precision": "", + "print_hide": 0, + "print_hide_if_no_value": 0, + "read_only": 0, + "report_hide": 0, + "reqd": 0, + "search_index": 0, + "set_only_once": 0, + "unique": 0 + } + ], + "hide_heading": 0, + "hide_toolbar": 0, + "idx": 0, + "image_view": 0, + "in_create": 0, + "in_dialog": 0, + "is_submittable": 0, + "issingle": 1, + "istable": 0, + "max_attachments": 0, + "modified": "2016-10-20 00:13:21.988739", + "modified_by": "Administrator", + "module": "Integrations", + "name": "OAuth Provider Settings", + "name_case": "", + "owner": "Administrator", + "permissions": [ + { + "amend": 0, + "apply_user_permissions": 0, + "cancel": 0, + "create": 1, + "delete": 1, + "email": 1, + "export": 0, + "if_owner": 0, + "import": 0, + "is_custom": 0, + "permlevel": 0, + "print": 1, + "read": 1, + "report": 0, + "role": "System Manager", + "set_user_permissions": 0, + "share": 1, + "submit": 0, + "write": 1 + } + ], + "quick_entry": 1, + "read_only": 0, + "read_only_onload": 0, + "sort_field": "modified", + "sort_order": "DESC", + "track_seen": 0 +} \ No newline at end of file diff --git a/frappe/integrations/doctype/oauth_provider_settings/oauth_provider_settings.py b/frappe/integrations/doctype/oauth_provider_settings/oauth_provider_settings.py new file mode 100644 index 0000000000..2bf086e0fe --- /dev/null +++ b/frappe/integrations/doctype/oauth_provider_settings/oauth_provider_settings.py @@ -0,0 +1,19 @@ +# -*- coding: utf-8 -*- +# Copyright (c) 2015, Frappe Technologies and contributors +# For license information, please see license.txt + +from __future__ import unicode_literals +import frappe +from frappe.model.document import Document +from frappe import _ + +class OAuthProviderSettings(Document): + pass + +def get_oauth_settings(): + """Returns oauth settings""" + out = frappe._dict({ + "skip_authorization" : frappe.db.get_value("OAuth Provider Settings", None, "skip_authorization") + }) + + return out \ No newline at end of file diff --git a/frappe/oauth.py b/frappe/oauth.py new file mode 100644 index 0000000000..22e1f17562 --- /dev/null +++ b/frappe/oauth.py @@ -0,0 +1,282 @@ +import frappe, urllib + +from urlparse import parse_qs, urlparse +from oauthlib.oauth2.rfc6749.tokens import BearerToken +from oauthlib.oauth2.rfc6749.grant_types import AuthorizationCodeGrant, ImplicitGrant, ResourceOwnerPasswordCredentialsGrant, ClientCredentialsGrant, RefreshTokenGrant +from oauthlib.oauth2 import RequestValidator +from oauthlib.oauth2.rfc6749.endpoints.authorization import AuthorizationEndpoint +from oauthlib.oauth2.rfc6749.endpoints.token import TokenEndpoint +from oauthlib.oauth2.rfc6749.endpoints.resource import ResourceEndpoint +from oauthlib.oauth2.rfc6749.endpoints.revocation import RevocationEndpoint +from oauthlib.common import Request + +class WebApplicationServer(AuthorizationEndpoint, TokenEndpoint, ResourceEndpoint, + RevocationEndpoint): + + """An all-in-one endpoint featuring Authorization code grant and Bearer tokens.""" + + def __init__(self, request_validator, token_generator=None, + token_expires_in=None, refresh_token_generator=None, **kwargs): + """Construct a new web application server. + + :param request_validator: An implementation of + oauthlib.oauth2.RequestValidator. + :param token_expires_in: An int or a function to generate a token + expiration offset (in seconds) given a + oauthlib.common.Request object. + :param token_generator: A function to generate a token from a request. + :param refresh_token_generator: A function to generate a token from a + request for the refresh token. + :param kwargs: Extra parameters to pass to authorization-, + token-, resource-, and revocation-endpoint constructors. + """ + auth_grant = AuthorizationCodeGrant(request_validator) + refresh_grant = RefreshTokenGrant(request_validator) + bearer = BearerToken(request_validator, token_generator, + token_expires_in, refresh_token_generator) + AuthorizationEndpoint.__init__(self, default_response_type='code', + response_types={'code': auth_grant}, + default_token_type=bearer) + TokenEndpoint.__init__(self, default_grant_type='authorization_code', + grant_types={ + 'authorization_code': auth_grant, + 'refresh_token': refresh_grant, + }, + default_token_type=bearer) + ResourceEndpoint.__init__(self, default_token='Bearer', + token_types={'Bearer': bearer}) + RevocationEndpoint.__init__(self, request_validator) + + +class OAuthWebRequestValidator(RequestValidator): + + # Pre- and post-authorization. + def validate_client_id(self, client_id, request, *args, **kwargs): + # Simple validity check, does client exist? Not banned? + cli_id = frappe.db.get_value("OAuth Client",{ "name":client_id }) + if cli_id: + request.client = frappe.get_doc("OAuth Client", client_id).as_dict() + return True + else: + return False + + def validate_redirect_uri(self, client_id, redirect_uri, request, *args, **kwargs): + # Is the client allowed to use the supplied redirect_uri? i.e. has + # the client previously registered this EXACT redirect uri. + + redirect_uris = frappe.db.get_value("OAuth Client", client_id, 'redirect_uris').split(';') + + if redirect_uri in redirect_uris: + return True + else: + return False + + def get_default_redirect_uri(self, client_id, request, *args, **kwargs): + # The redirect used if none has been supplied. + # Prefer your clients to pre register a redirect uri rather than + # supplying one on each authorization request. + redirect_uri = frappe.db.get_value("OAuth Client", client_id, 'default_redirect_uri') + return redirect_uri + + def validate_scopes(self, client_id, scopes, client, request, *args, **kwargs): + # Is the client allowed to access the requested scopes? + client_scopes = frappe.db.get_value("OAuth Client", client_id, 'scopes').split(';') + + are_scopes_valid = True + + for scp in scopes: + are_scopes_valid = are_scopes_valid and True if scp in client_scopes else False + + return are_scopes_valid + + def get_default_scopes(self, client_id, request, *args, **kwargs): + # Scopes a client will authorize for if none are supplied in the + # authorization request. + scopes = frappe.db.get_value("OAuth Client", client_id, 'scopes').split(';') + request.scopes = scopes #Apparently this is possible. + return scopes + + def validate_response_type(self, client_id, response_type, client, request, *args, **kwargs): + # Clients should only be allowed to use one type of response type, the + # one associated with their one allowed grant type. + # In this case it must be "code". + + return (client.response_type.lower() == response_type) + + + # Post-authorization + + def save_authorization_code(self, client_id, code, request, *args, **kwargs): + + cookie_dict = get_cookie_dict_from_headers(request) + + oac = frappe.new_doc('OAuth Authorization Code') + oac.scopes = ';'.join(request.scopes) + oac.redirect_uri_bound_to_authorization_code = request.redirect_uri + oac.client = client_id + oac.user = urllib.unquote(cookie_dict['user_id']) + oac.authorization_code = code['code'] + oac.save(ignore_permissions=True) + frappe.db.commit() + + def authenticate_client(self, request, *args, **kwargs): + + cookie_dict = get_cookie_dict_from_headers(request) + + #Get ClientID in URL + if request.client_id: + oc = frappe.get_doc("OAuth Client", request.client_id) + else: + #Extract token, instantiate OAuth Bearer Token and use clientid from there. + if frappe.form_dict.has_key("refresh_token"): + oc = frappe.get_doc("OAuth Client", frappe.db.get_value("OAuth Bearer Token", {"refresh_token": frappe.form_dict["refresh_token"]}, 'client')) + else: + oc = frappe.get_doc("OAuth Client", frappe.db.get_value("OAuth Bearer Token", frappe.form_dict["token"], 'client')) + try: + request.client = request.client or oc.as_dict() + except Exception, e: + print "Failed body authentication: Application %s does not exist".format(cid=request.client_id) + + return frappe.session.user == urllib.unquote(cookie_dict.get('user_id', "Guest")) + + def authenticate_client_id(self, client_id, request, *args, **kwargs): + cli_id = frappe.db.get_value('OAuth Client', client_id, 'name') + if not cli_id: + # Don't allow public (non-authenticated) clients + return False + else: + request["client"] = frappe.get_doc("OAuth Client", cli_id) + return True + + def validate_code(self, client_id, code, client, request, *args, **kwargs): + # Validate the code belongs to the client. Add associated scopes, + # state and user to request.scopes and request.user. + + validcodes = frappe.get_all("OAuth Authorization Code", filters={"client": client_id, "validity": "Valid"}) + + checkcodes = [] + for vcode in validcodes: + checkcodes.append(vcode["name"]) + + if code in checkcodes: + request.scopes = frappe.db.get_value("OAuth Authorization Code", code, 'scopes').split(';') + request.user = frappe.db.get_value("OAuth Authorization Code", code, 'user') + return True + else: + return False + + def confirm_redirect_uri(self, client_id, code, redirect_uri, client, *args, **kwargs): + saved_redirect_uri = frappe.db.get_value('OAuth Client', client_id, 'default_redirect_uri') + + return saved_redirect_uri == redirect_uri + + def validate_grant_type(self, client_id, grant_type, client, request, *args, **kwargs): + # Clients should only be allowed to use one type of grant. + # In this case, it must be "authorization_code" or "refresh_token" + return (grant_type in ["authorization_code", "refresh_token"]) + + def save_bearer_token(self, token, request, *args, **kwargs): + # Remember to associate it with request.scopes, request.user and + # request.client. The two former will be set when you validate + # the authorization code. Don't forget to save both the + # access_token and the refresh_token and set expiration for the + # access_token to now + expires_in seconds. + + otoken = frappe.new_doc("OAuth Bearer Token") + otoken.client = request.client['name'] + otoken.user = request.user + otoken.scopes = ";".join(request.scopes) + otoken.access_token = token['access_token'] + otoken.refresh_token = token['refresh_token'] + otoken.expires_in = token['expires_in'] + otoken.save(ignore_permissions=True) + frappe.db.commit() + + default_redirect_uri = frappe.db.get_value("OAuth Client", request.client['name'], "default_redirect_uri") + return default_redirect_uri + + def invalidate_authorization_code(self, client_id, code, request, *args, **kwargs): + # Authorization codes are use once, invalidate it when a Bearer token + # has been acquired. + + frappe.db.set_value("OAuth Authorization Code", code, "validity", "Invalid") + frappe.db.commit() + + # Protected resource request + + def validate_bearer_token(self, token, scopes, request): + # Remember to check expiration and scope membership + otoken = frappe.get_doc("OAuth Bearer Token", token) #{"access_token": str(token)}) + is_token_valid = (frappe.utils.datetime.datetime.now() < otoken.expiration_time) \ + and otoken.status != "Revoked" + client_scopes = frappe.db.get_value("OAuth Client", otoken.client, 'scopes').split(';') + are_scopes_valid = True + for scp in scopes: + are_scopes_valid = are_scopes_valid and True if scp in client_scopes else False + + return is_token_valid and are_scopes_valid + + # Token refresh request + def get_original_scopes(self, refresh_token, request, *args, **kwargs): + # Obtain the token associated with the given refresh_token and + # return its scopes, these will be passed on to the refreshed + # access token if the client did not specify a scope during the + # request. + obearer_token = frappe.get_doc("OAuth Bearer Token", {"refresh_token": refresh_token}) + return obearer_token.scopes + + def revoke_token(self, token, token_type_hint, request, *args, **kwargs): + """Revoke an access or refresh token. + + :param token: The token string. + :param token_type_hint: access_token or refresh_token. + :param request: The HTTP Request (oauthlib.common.Request) + + Method is used by: + - Revocation Endpoint + """ + otoken = None + + if token_type_hint == "access_token": + otoken = frappe.db.set_value("OAuth Bearer Token", token, 'status', 'Revoked') + elif token_type_hint == "refresh_token": + otoken = frappe.db.set_value("OAuth Bearer Token", {"refresh_token": token}, 'status', 'Revoked') + else: + otoken = frappe.db.set_value("OAuth Bearer Token", token, 'status', 'Revoked') + frappe.db.commit() + + def validate_refresh_token(self, refresh_token, client, request, *args, **kwargs): + # """Ensure the Bearer token is valid and authorized access to scopes. + + # OBS! The request.user attribute should be set to the resource owner + # associated with this refresh token. + + # :param refresh_token: Unicode refresh token + # :param client: Client object set by you, see authenticate_client. + # :param request: The HTTP Request (oauthlib.common.Request) + # :rtype: True or False + + # Method is used by: + # - Authorization Code Grant (indirectly by issuing refresh tokens) + # - Resource Owner Password Credentials Grant (also indirectly) + # - Refresh Token Grant + # """ + # raise NotImplementedError('Subclasses must implement this method.') + + otoken = frappe.get_doc("OAuth Bearer Token", {"refresh_token": refresh_token, "status": "Active"}) + + if not otoken: + return False + else: + return True + + #TODO: Validate scopes. + +def get_cookie_dict_from_headers(r): + if r.headers.get('Cookie'): + cookie = r.headers.get('Cookie') + cookie = cookie.split("; ") + cookie_dict = {k:v for k,v in (x.split('=') for x in cookie)} + return cookie_dict + else: + return {} diff --git a/frappe/templates/includes/oauth_confirmation.html b/frappe/templates/includes/oauth_confirmation.html new file mode 100644 index 0000000000..3b0868e34d --- /dev/null +++ b/frappe/templates/includes/oauth_confirmation.html @@ -0,0 +1,47 @@ +{% if not error %} +
+
+

{{ client_id }} wants to access the following details from your account

+
+
+
    + {% for dtl in details %} +
  • {{ dtl.title() }}
    • + {% endfor %} +
+
    +
  • + +
    • +
  • + +
    • +
+
+
+ +{% else %} +
+
+

Authorization error for {{ client_id }}

+
+
+

An unexpected error occurred while authorizing {{ client_id }}.

+

{{ error }}

+
    +
  • + +
    • +
+
+
+{% endif %} \ No newline at end of file diff --git a/requirements.txt b/requirements.txt index c198014550..486e96a8a7 100644 --- a/requirements.txt +++ b/requirements.txt @@ -38,3 +38,4 @@ zxcvbn psutil unittest-xml-reporting xlwt +oauthlib