Merge branch 'master' into docs-flows
# Conflicts: # mkdocs.yml
This commit is contained in:
commit
4ff41be74a
1
Pipfile
1
Pipfile
|
@ -40,7 +40,6 @@ signxml = "*"
|
||||||
structlog = "*"
|
structlog = "*"
|
||||||
swagger-spec-validator = "*"
|
swagger-spec-validator = "*"
|
||||||
urllib3 = {extras = ["secure"],version = "*"}
|
urllib3 = {extras = ["secure"],version = "*"}
|
||||||
jinja2 = "*"
|
|
||||||
|
|
||||||
[requires]
|
[requires]
|
||||||
python_version = "3.8"
|
python_version = "3.8"
|
||||||
|
|
|
@ -53,26 +53,26 @@
|
||||||
},
|
},
|
||||||
"boto3": {
|
"boto3": {
|
||||||
"hashes": [
|
"hashes": [
|
||||||
"sha256:26f8564b46d009b8f4c6470a6d6cde147b282a197339c7e31cbb0fe9fd9e5f5d",
|
"sha256:bcaa88b2f81b88741c47da52f3414c876236700441df87b6198f860e6a200d6f",
|
||||||
"sha256:f59d0bd230ed3a4b932c5c4e497a0e0ff3c93b46b7e8cde54efb6fe10c8266ba"
|
"sha256:e974e7a3bbdbd6a73ffc07bea5fa0c0744a5a8b87dcca94702597176e3de465e"
|
||||||
],
|
],
|
||||||
"index": "pypi",
|
"index": "pypi",
|
||||||
"version": "==1.13.20"
|
"version": "==1.13.23"
|
||||||
},
|
},
|
||||||
"botocore": {
|
"botocore": {
|
||||||
"hashes": [
|
"hashes": [
|
||||||
"sha256:990f3fc33dec746829740b1a9e1fe86183cdc96aedba6a632ccfcbae03e097cc",
|
"sha256:5831068c9b49b4c91b0733e0ec784a7733d8732359d73c67a07a0b0868433cae",
|
||||||
"sha256:d4cc47ac989a7f1d2992ef7679fb423a7966f687becf623a291a555a2d7ce1c0"
|
"sha256:7778957bdc9a25dd33bb4383ebd6d45a8570a2cbff03d1edf430fdacec2b7437"
|
||||||
],
|
],
|
||||||
"version": "==1.16.20"
|
"version": "==1.16.23"
|
||||||
},
|
},
|
||||||
"celery": {
|
"celery": {
|
||||||
"hashes": [
|
"hashes": [
|
||||||
"sha256:108a0bf9018a871620936c33a3ee9f6336a89f8ef0a0f567a9001f4aa361415f",
|
"sha256:9ae2e73b93cc7d6b48b56aaf49a68c91752d0ffd7dfdcc47f842ca79a6f13eae",
|
||||||
"sha256:5b4b37e276033fe47575107a2775469f0b721646a08c96ec2c61531e4fe45f2a"
|
"sha256:c2037b6a8463da43b19969a0fc13f9023ceca6352b4dd51be01c66fbbb13647e"
|
||||||
],
|
],
|
||||||
"index": "pypi",
|
"index": "pypi",
|
||||||
"version": "==4.4.2"
|
"version": "==4.4.4"
|
||||||
},
|
},
|
||||||
"certifi": {
|
"certifi": {
|
||||||
"hashes": [
|
"hashes": [
|
||||||
|
@ -169,11 +169,11 @@
|
||||||
},
|
},
|
||||||
"django": {
|
"django": {
|
||||||
"hashes": [
|
"hashes": [
|
||||||
"sha256:051ba55d42daa3eeda3944a8e4df2bc96d4c62f94316dea217248a22563c3621",
|
"sha256:5052b34b34b3425233c682e0e11d658fd6efd587d11335a0203d827224ada8f2",
|
||||||
"sha256:9aaa6a09678e1b8f0d98a948c56482eac3e3dd2ddbfb8de70a868135ef3b5e01"
|
"sha256:e1630333248c9b3d4e38f02093a26f1e07b271ca896d73097457996e0fae12e8"
|
||||||
],
|
],
|
||||||
"index": "pypi",
|
"index": "pypi",
|
||||||
"version": "==3.0.6"
|
"version": "==3.0.7"
|
||||||
},
|
},
|
||||||
"django-cors-middleware": {
|
"django-cors-middleware": {
|
||||||
"hashes": [
|
"hashes": [
|
||||||
|
@ -345,7 +345,6 @@
|
||||||
"sha256:c10142f819c2d22bdcd17548c46fa9b77cf4fda45097854c689666bf425e7484",
|
"sha256:c10142f819c2d22bdcd17548c46fa9b77cf4fda45097854c689666bf425e7484",
|
||||||
"sha256:c922560ac46888d47384de1dbdc3daaa2ea993af4b26a436dec31fa2c19ec668"
|
"sha256:c922560ac46888d47384de1dbdc3daaa2ea993af4b26a436dec31fa2c19ec668"
|
||||||
],
|
],
|
||||||
"index": "pypi",
|
|
||||||
"version": "==3.0.0a1"
|
"version": "==3.0.0a1"
|
||||||
},
|
},
|
||||||
"jmespath": {
|
"jmespath": {
|
||||||
|
@ -364,11 +363,11 @@
|
||||||
},
|
},
|
||||||
"kombu": {
|
"kombu": {
|
||||||
"hashes": [
|
"hashes": [
|
||||||
"sha256:ab0afaa5388dd2979cbc439d3623b86a4f7a58d41f621096bef7767c37bc2505",
|
"sha256:437b9cdea193cc2ed0b8044c85fd0f126bb3615ca2f4d4a35b39de7cacfa3c1a",
|
||||||
"sha256:aece08f48706743aaa1b9d607fee300559481eafcc5ee56451aa0ef867a3be07"
|
"sha256:dc282bb277197d723bccda1a9ba30a27a28c9672d0ab93e9e51bb05a37bd29c3"
|
||||||
],
|
],
|
||||||
"index": "pypi",
|
"index": "pypi",
|
||||||
"version": "==4.6.9"
|
"version": "==4.6.10"
|
||||||
},
|
},
|
||||||
"ldap3": {
|
"ldap3": {
|
||||||
"hashes": [
|
"hashes": [
|
||||||
|
@ -948,11 +947,11 @@
|
||||||
},
|
},
|
||||||
"django": {
|
"django": {
|
||||||
"hashes": [
|
"hashes": [
|
||||||
"sha256:051ba55d42daa3eeda3944a8e4df2bc96d4c62f94316dea217248a22563c3621",
|
"sha256:5052b34b34b3425233c682e0e11d658fd6efd587d11335a0203d827224ada8f2",
|
||||||
"sha256:9aaa6a09678e1b8f0d98a948c56482eac3e3dd2ddbfb8de70a868135ef3b5e01"
|
"sha256:e1630333248c9b3d4e38f02093a26f1e07b271ca896d73097457996e0fae12e8"
|
||||||
],
|
],
|
||||||
"index": "pypi",
|
"index": "pypi",
|
||||||
"version": "==3.0.6"
|
"version": "==3.0.7"
|
||||||
},
|
},
|
||||||
"django-debug-toolbar": {
|
"django-debug-toolbar": {
|
||||||
"hashes": [
|
"hashes": [
|
||||||
|
@ -1133,10 +1132,10 @@
|
||||||
},
|
},
|
||||||
"stevedore": {
|
"stevedore": {
|
||||||
"hashes": [
|
"hashes": [
|
||||||
"sha256:18afaf1d623af5950cc0f7e75e70f917784c73b652a34a12d90b309451b5500b",
|
"sha256:001e90cd704be6470d46cc9076434e2d0d566c1379187e7013eb296d3a6032d9",
|
||||||
"sha256:a4e7dc759fb0f2e3e2f7d8ffe2358c19d45b9b8297f393ef1256858d82f69c9b"
|
"sha256:471c920412265cc809540ae6fb01f3f02aba89c79bbc7091372f4745a50f9691"
|
||||||
],
|
],
|
||||||
"version": "==1.32.0"
|
"version": "==2.0.0"
|
||||||
},
|
},
|
||||||
"toml": {
|
"toml": {
|
||||||
"hashes": [
|
"hashes": [
|
||||||
|
|
|
@ -32,8 +32,8 @@ For bigger setups, there is a Helm Chart in the `helm/` directory. This is docum
|
||||||
|
|
||||||
## Screenshots
|
## Screenshots
|
||||||
|
|
||||||
![](.github/screen_apps.png)
|
![](docs/images/screen_apps.png)
|
||||||
![](.github/screen_admin.png)
|
![](docs/images/screen_admin.png)
|
||||||
|
|
||||||
## Development
|
## Development
|
||||||
|
|
||||||
|
|
|
@ -0,0 +1,55 @@
|
||||||
|
# Expressions
|
||||||
|
|
||||||
|
Expressions allow you to write custom Logic using Python code.
|
||||||
|
|
||||||
|
Expressions are used in different places throughout passbook, and can do different things.
|
||||||
|
|
||||||
|
!!! info
|
||||||
|
These functions/objects are available wherever expressions are used. For more specific information, see [Expression Policies](../policies/expression.md) and [Property Mappings](../property-mappings/expression.md)
|
||||||
|
|
||||||
|
## Global objects
|
||||||
|
|
||||||
|
- `pb_logger`: structlog BoundLogger. ([ref](https://www.structlog.org/en/stable/api.html#structlog.BoundLogger))
|
||||||
|
- `requests`: requests Session object. ([ref](https://requests.readthedocs.io/en/master/user/advanced/))
|
||||||
|
|
||||||
|
## Generally available functions
|
||||||
|
|
||||||
|
### `regex_match(value: Any, regex: str) -> bool`
|
||||||
|
|
||||||
|
Check if `value` matches Regular Expression `regex`.
|
||||||
|
|
||||||
|
Example:
|
||||||
|
|
||||||
|
```python
|
||||||
|
return regex_match(request.user.username, '.*admin.*')
|
||||||
|
```
|
||||||
|
|
||||||
|
### `regex_replace(value: Any, regex: str, repl: str) -> str`
|
||||||
|
|
||||||
|
Replace anything matching `regex` within `value` with `repl` and return it.
|
||||||
|
|
||||||
|
Example:
|
||||||
|
|
||||||
|
```python
|
||||||
|
user_email_local = regex_replace(request.user.email, '(.+)@.+', '')
|
||||||
|
```
|
||||||
|
|
||||||
|
### `pb_is_group_member(user: User, **group_filters) -> bool`
|
||||||
|
|
||||||
|
Check if `user` is member of a group matching `**group_filters`.
|
||||||
|
|
||||||
|
Example:
|
||||||
|
|
||||||
|
```python
|
||||||
|
return pb_is_group_member(request.user, name="test_group")
|
||||||
|
```
|
||||||
|
|
||||||
|
### `pb_user_by(**filters) -> Optional[User]`
|
||||||
|
|
||||||
|
Fetch a user matching `**filters`. Returns None if no user was found.
|
||||||
|
|
||||||
|
Example:
|
||||||
|
|
||||||
|
```python
|
||||||
|
other_user = pb_user_by(username="other_user")
|
||||||
|
```
|
|
@ -15,6 +15,7 @@ The User object has the following attributes:
|
||||||
|
|
||||||
List all the User's Group Names
|
List all the User's Group Names
|
||||||
|
|
||||||
```jinja2
|
```python
|
||||||
[{% for group in user.groups.all() %}'{{ group.name }}',{% endfor %}]
|
for group in user.groups.all():
|
||||||
|
yield group.name
|
||||||
```
|
```
|
|
@ -0,0 +1,27 @@
|
||||||
|
# Expression Policies
|
||||||
|
|
||||||
|
The passing of the policy is determined by the return value of the code. Use `return True` to pass a policy and `return False` to fail it.
|
||||||
|
|
||||||
|
### Available Functions
|
||||||
|
|
||||||
|
#### `pb_message(message: str)`
|
||||||
|
|
||||||
|
Add a message, visible by the end user. This can be used to show the reason why they were denied.
|
||||||
|
|
||||||
|
Example:
|
||||||
|
|
||||||
|
```python
|
||||||
|
pb_message("Access denied")
|
||||||
|
return False
|
||||||
|
```
|
||||||
|
|
||||||
|
### Context variables
|
||||||
|
|
||||||
|
- `request`: A PolicyRequest object, which has the following properties:
|
||||||
|
- `request.user`: The current User, which the Policy is applied against. ([ref](../expressions/reference/user-object.md))
|
||||||
|
- `request.http_request`: The Django HTTP Request. ([ref](https://docs.djangoproject.com/en/3.0/ref/request-response/#httprequest-objects))
|
||||||
|
- `request.obj`: A Django Model instance. This is only set if the Policy is ran against an object.
|
||||||
|
- `request.context`: A dictionary with dynamic data. This depends on the origin of the execution.
|
||||||
|
- `pb_is_sso_flow`: Boolean which is true if request was initiated by authenticating through an external Provider.
|
||||||
|
- `pb_client_ip`: Client's IP Address or '255.255.255.255' if no IP Address could be extracted.
|
||||||
|
- `pb_flow_plan`: Current Plan if Policy is called from the Flow Planner.
|
|
@ -1,22 +0,0 @@
|
||||||
# Expression Policy
|
|
||||||
|
|
||||||
Expression Policies allows you to write custom Policy Logic using Jinja2 Templating language.
|
|
||||||
|
|
||||||
For a language reference, see [here](https://jinja.palletsprojects.com/en/2.11.x/templates/).
|
|
||||||
|
|
||||||
The following objects are passed into the variable:
|
|
||||||
|
|
||||||
- `request`: A PolicyRequest object, which has the following properties:
|
|
||||||
- `request.user`: The current User, which the Policy is applied against. ([ref](../../property-mappings/reference/user-object.md))
|
|
||||||
- `request.http_request`: The Django HTTP Request, as documented [here](https://docs.djangoproject.com/en/3.0/ref/request-response/#httprequest-objects).
|
|
||||||
- `request.obj`: A Django Model instance. This is only set if the Policy is ran against an object.
|
|
||||||
- `pb_flow_plan`: Current Plan if Policy is called while a flow is active.
|
|
||||||
- `pb_is_sso_flow`: Boolean which is true if request was initiated by authenticating through an external Provider.
|
|
||||||
- `pb_is_group_member(user, group_name)`: Function which checks if `user` is member of a Group with Name `gorup_name`.
|
|
||||||
- `pb_logger`: Standard Python Logger Object, which can be used to debug expressions.
|
|
||||||
- `pb_client_ip`: Client's IP Address.
|
|
||||||
|
|
||||||
There are also the following custom filters available:
|
|
||||||
|
|
||||||
- `regex_match(regex)`: Return True if value matches `regex`
|
|
||||||
- `regex_replace(regex, repl)`: Replace string matched by `regex` with `repl`
|
|
|
@ -8,10 +8,6 @@ There are two different Kind of policies, a Standard Policy and a Password Polic
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### Group-Membership Policy
|
|
||||||
|
|
||||||
This policy evaluates to True if the current user is a Member of the selected group.
|
|
||||||
|
|
||||||
### Reputation Policy
|
### Reputation Policy
|
||||||
|
|
||||||
passbook keeps track of failed login attempts by Source IP and Attempted Username. These values are saved as scores. Each failed login decreases the Score for the Client IP as well as the targeted Username by one.
|
passbook keeps track of failed login attempts by Source IP and Attempted Username. These values are saved as scores. Each failed login decreases the Score for the Client IP as well as the targeted Username by one.
|
||||||
|
@ -20,11 +16,7 @@ This policy can be used to for example prompt Clients with a low score to pass a
|
||||||
|
|
||||||
## Expression Policy
|
## Expression Policy
|
||||||
|
|
||||||
See [Expression Policy](expression/index.md).
|
See [Expression Policy](expression.md).
|
||||||
|
|
||||||
### Webhook Policy
|
|
||||||
|
|
||||||
This policy allows you to send an arbitrary HTTP Request to any URL. You can then use JSONPath to extract the result you need.
|
|
||||||
|
|
||||||
## Password Policies
|
## Password Policies
|
||||||
|
|
||||||
|
|
|
@ -0,0 +1,9 @@
|
||||||
|
# Property Mapping Expressions
|
||||||
|
|
||||||
|
The property mapping should return a value that is expected by the Provider/Source. What types are supported, is documented in the individual Provider/Source. Returning `None` is always accepted, this simply skips this mapping.
|
||||||
|
|
||||||
|
### Context Variables
|
||||||
|
|
||||||
|
- `user`: The current user, this might be `None` if there is no contextual user. ([ref](../expressions/reference/user-object.md))
|
||||||
|
- `request`: The current request, this might be `None` if there is no contextual request. ([ref](https://docs.djangoproject.com/en/3.0/ref/request-response/#httprequest-objects))
|
||||||
|
- Arbitrary other arguments given by the provider, this is documented on the Provider/Source.
|
27
mkdocs.yml
27
mkdocs.yml
|
@ -4,6 +4,7 @@ copyright: "Copyright © 2019 - 2020 BeryJu.org"
|
||||||
|
|
||||||
nav:
|
nav:
|
||||||
- Home: index.md
|
- Home: index.md
|
||||||
|
- Terminology: terminology.md
|
||||||
- Installation:
|
- Installation:
|
||||||
- docker-compose: installation/docker-compose.md
|
- docker-compose: installation/docker-compose.md
|
||||||
- Kubernetes: installation/kubernetes.md
|
- Kubernetes: installation/kubernetes.md
|
||||||
|
@ -24,13 +25,16 @@ nav:
|
||||||
- User Write Stage: flow/stages/user_write.md
|
- User Write Stage: flow/stages/user_write.md
|
||||||
- Sources: sources.md
|
- Sources: sources.md
|
||||||
- Providers: providers.md
|
- Providers: providers.md
|
||||||
|
- Expressions:
|
||||||
|
- Overview: expressions/index.md
|
||||||
|
- Reference:
|
||||||
|
- User Object: expressions/reference/user-object.md
|
||||||
- Property Mappings:
|
- Property Mappings:
|
||||||
- Overview: property-mappings/index.md
|
- Overview: property-mappings/index.md
|
||||||
- Reference:
|
- Expressions: property-mappings/expression.md
|
||||||
- User Object: property-mappings/reference/user-object.md
|
|
||||||
- Policies:
|
- Policies:
|
||||||
- Overview: policies/index.md
|
- Overview: policies/index.md
|
||||||
- Expression: policies/expression/index.md
|
- Expression: policies/expression.md
|
||||||
- Integrations:
|
- Integrations:
|
||||||
- as Provider:
|
- as Provider:
|
||||||
- Amazon Web Services: integrations/services/aws/index.md
|
- Amazon Web Services: integrations/services/aws/index.md
|
||||||
|
@ -44,10 +48,23 @@ nav:
|
||||||
repo_name: "BeryJu/passbook"
|
repo_name: "BeryJu/passbook"
|
||||||
repo_url: https://github.com/BeryJu/passbook
|
repo_url: https://github.com/BeryJu/passbook
|
||||||
theme:
|
theme:
|
||||||
name: "material"
|
name: material
|
||||||
logo: "images/logo.svg"
|
logo: images/logo.svg
|
||||||
|
favicon: images/logo.svg
|
||||||
|
palette:
|
||||||
|
scheme: slate
|
||||||
|
primary: white
|
||||||
|
|
||||||
markdown_extensions:
|
markdown_extensions:
|
||||||
- toc:
|
- toc:
|
||||||
permalink: "¶"
|
permalink: "¶"
|
||||||
- admonition
|
- admonition
|
||||||
|
- codehilite
|
||||||
|
- pymdownx.betterem:
|
||||||
|
smart_enable: all
|
||||||
|
- pymdownx.inlinehilite
|
||||||
|
- pymdownx.magiclink
|
||||||
|
- attr_list
|
||||||
|
|
||||||
|
plugins:
|
||||||
|
- search
|
||||||
|
|
|
@ -14,7 +14,7 @@
|
||||||
<link rel="stylesheet" href="{% static 'node_modules/codemirror/theme/monokai.css' %}">
|
<link rel="stylesheet" href="{% static 'node_modules/codemirror/theme/monokai.css' %}">
|
||||||
<script src="{% static 'node_modules/codemirror/mode/xml/xml.js' %}"></script>
|
<script src="{% static 'node_modules/codemirror/mode/xml/xml.js' %}"></script>
|
||||||
<script src="{% static 'node_modules/codemirror/mode/yaml/yaml.js' %}"></script>
|
<script src="{% static 'node_modules/codemirror/mode/yaml/yaml.js' %}"></script>
|
||||||
<script src="{% static 'node_modules/codemirror/mode/jinja2/jinja2.js' %}"></script>
|
<script src="{% static 'node_modules/codemirror/mode/python/python.js' %}"></script>
|
||||||
{% endblock %}
|
{% endblock %}
|
||||||
|
|
||||||
{% block page_content %}
|
{% block page_content %}
|
||||||
|
|
|
@ -0,0 +1,21 @@
|
||||||
|
"""Property Mapping Evaluator"""
|
||||||
|
from typing import Optional
|
||||||
|
|
||||||
|
from django.http import HttpRequest
|
||||||
|
|
||||||
|
from passbook.core.models import User
|
||||||
|
from passbook.lib.expression.evaluator import BaseEvaluator
|
||||||
|
|
||||||
|
|
||||||
|
class PropertyMappingEvaluator(BaseEvaluator):
|
||||||
|
"""Custom Evalautor that adds some different context variables."""
|
||||||
|
|
||||||
|
def set_context(
|
||||||
|
self, user: Optional[User], request: Optional[HttpRequest], **kwargs
|
||||||
|
):
|
||||||
|
"""Update context with context from PropertyMapping's evaluate"""
|
||||||
|
if user:
|
||||||
|
self._context["user"] = user
|
||||||
|
if request:
|
||||||
|
self._context["request"] = request
|
||||||
|
self._context.update(**kwargs)
|
|
@ -14,6 +14,7 @@ def create_default_user(apps: Apps, schema_editor: BaseDatabaseSchemaEditor):
|
||||||
)
|
)
|
||||||
pbadmin.set_password("pbadmin") # nosec
|
pbadmin.set_password("pbadmin") # nosec
|
||||||
pbadmin.is_superuser = True
|
pbadmin.is_superuser = True
|
||||||
|
pbadmin.is_staff = True
|
||||||
pbadmin.save()
|
pbadmin.save()
|
||||||
|
|
||||||
|
|
||||||
|
|
|
@ -5,14 +5,11 @@ from uuid import uuid4
|
||||||
|
|
||||||
from django.contrib.auth.models import AbstractUser
|
from django.contrib.auth.models import AbstractUser
|
||||||
from django.contrib.postgres.fields import JSONField
|
from django.contrib.postgres.fields import JSONField
|
||||||
from django.core.exceptions import ValidationError
|
|
||||||
from django.db import models
|
from django.db import models
|
||||||
from django.http import HttpRequest
|
from django.http import HttpRequest
|
||||||
from django.utils.timezone import now
|
from django.utils.timezone import now
|
||||||
from django.utils.translation import gettext_lazy as _
|
from django.utils.translation import gettext_lazy as _
|
||||||
from guardian.mixins import GuardianUserMixin
|
from guardian.mixins import GuardianUserMixin
|
||||||
from jinja2 import Undefined
|
|
||||||
from jinja2.exceptions import TemplateSyntaxError, UndefinedError
|
|
||||||
from model_utils.managers import InheritanceManager
|
from model_utils.managers import InheritanceManager
|
||||||
from structlog import get_logger
|
from structlog import get_logger
|
||||||
|
|
||||||
|
@ -206,30 +203,14 @@ class PropertyMapping(models.Model):
|
||||||
self, user: Optional[User], request: Optional[HttpRequest], **kwargs
|
self, user: Optional[User], request: Optional[HttpRequest], **kwargs
|
||||||
) -> Any:
|
) -> Any:
|
||||||
"""Evaluate `self.expression` using `**kwargs` as Context."""
|
"""Evaluate `self.expression` using `**kwargs` as Context."""
|
||||||
from passbook.policies.expression.evaluator import Evaluator
|
from passbook.core.expression import PropertyMappingEvaluator
|
||||||
|
|
||||||
evaluator = Evaluator()
|
evaluator = PropertyMappingEvaluator()
|
||||||
|
evaluator.set_context(user, request, **kwargs)
|
||||||
try:
|
try:
|
||||||
expression = evaluator.env.from_string(self.expression)
|
return evaluator.evaluate(self.expression)
|
||||||
except TemplateSyntaxError as exc:
|
except (ValueError, SyntaxError) as exc:
|
||||||
raise PropertyMappingExpressionException from exc
|
raise PropertyMappingExpressionException from exc
|
||||||
try:
|
|
||||||
response = expression.render(user=user, request=request, **kwargs)
|
|
||||||
if isinstance(response, Undefined):
|
|
||||||
raise PropertyMappingExpressionException("Response was 'Undefined'")
|
|
||||||
return response
|
|
||||||
except UndefinedError as exc:
|
|
||||||
raise PropertyMappingExpressionException from exc
|
|
||||||
|
|
||||||
def save(self, *args, **kwargs):
|
|
||||||
from passbook.policies.expression.evaluator import Evaluator
|
|
||||||
|
|
||||||
evaluator = Evaluator()
|
|
||||||
try:
|
|
||||||
evaluator.env.from_string(self.expression)
|
|
||||||
except TemplateSyntaxError as exc:
|
|
||||||
raise ValidationError("Expression Syntax Error") from exc
|
|
||||||
return super().save(*args, **kwargs)
|
|
||||||
|
|
||||||
def __str__(self):
|
def __str__(self):
|
||||||
return f"Property Mapping {self.name}"
|
return f"Property Mapping {self.name}"
|
||||||
|
|
|
@ -0,0 +1,101 @@
|
||||||
|
"""passbook expression policy evaluator"""
|
||||||
|
import re
|
||||||
|
from textwrap import indent
|
||||||
|
from typing import Any, Dict, Iterable, Optional
|
||||||
|
|
||||||
|
from django.core.exceptions import ValidationError
|
||||||
|
from requests import Session
|
||||||
|
from structlog import get_logger
|
||||||
|
|
||||||
|
from passbook.core.models import User
|
||||||
|
|
||||||
|
LOGGER = get_logger()
|
||||||
|
|
||||||
|
|
||||||
|
class BaseEvaluator:
|
||||||
|
"""Validate and evaluate python-based expressions"""
|
||||||
|
|
||||||
|
# Globals that can be used by function
|
||||||
|
_globals: Dict[str, Any]
|
||||||
|
# Context passed as locals to exec()
|
||||||
|
_context: Dict[str, Any]
|
||||||
|
|
||||||
|
# Filename used for exec
|
||||||
|
_filename: str
|
||||||
|
|
||||||
|
def __init__(self):
|
||||||
|
# update passbook/policies/expression/templates/policy/expression/form.html
|
||||||
|
# update docs/policies/expression/index.md
|
||||||
|
self._globals = {
|
||||||
|
"regex_match": BaseEvaluator.expr_filter_regex_match,
|
||||||
|
"regex_replace": BaseEvaluator.expr_filter_regex_replace,
|
||||||
|
"pb_is_group_member": BaseEvaluator.expr_func_is_group_member,
|
||||||
|
"pb_user_by": BaseEvaluator.expr_func_user_by,
|
||||||
|
"pb_logger": get_logger(),
|
||||||
|
"requests": Session(),
|
||||||
|
}
|
||||||
|
self._context = {}
|
||||||
|
self._filename = "BaseEvalautor"
|
||||||
|
|
||||||
|
@staticmethod
|
||||||
|
def expr_filter_regex_match(value: Any, regex: str) -> bool:
|
||||||
|
"""Expression Filter to run re.search"""
|
||||||
|
return re.search(regex, value) is None
|
||||||
|
|
||||||
|
@staticmethod
|
||||||
|
def expr_filter_regex_replace(value: Any, regex: str, repl: str) -> str:
|
||||||
|
"""Expression Filter to run re.sub"""
|
||||||
|
return re.sub(regex, repl, value)
|
||||||
|
|
||||||
|
@staticmethod
|
||||||
|
def expr_func_user_by(**filters) -> Optional[User]:
|
||||||
|
"""Get user by filters"""
|
||||||
|
users = User.objects.filter(**filters)
|
||||||
|
if users:
|
||||||
|
return users.first()
|
||||||
|
return None
|
||||||
|
|
||||||
|
@staticmethod
|
||||||
|
def expr_func_is_group_member(user: User, **group_filters) -> bool:
|
||||||
|
"""Check if `user` is member of group with name `group_name`"""
|
||||||
|
return user.groups.filter(**group_filters).exists()
|
||||||
|
|
||||||
|
def wrap_expression(self, expression: str, params: Iterable[str]) -> str:
|
||||||
|
"""Wrap expression in a function, call it, and save the result as `result`"""
|
||||||
|
handler_signature = ",".join(params)
|
||||||
|
full_expression = f"def handler({handler_signature}):\n"
|
||||||
|
full_expression += indent(expression, " ")
|
||||||
|
full_expression += f"\nresult = handler({handler_signature})"
|
||||||
|
return full_expression
|
||||||
|
|
||||||
|
def evaluate(self, expression_source: str) -> Any:
|
||||||
|
"""Parse and evaluate expression. If the syntax is incorrect, a SyntaxError is raised.
|
||||||
|
If any exception is raised during execution, it is raised.
|
||||||
|
The result is returned without any type-checking."""
|
||||||
|
param_keys = self._context.keys()
|
||||||
|
ast_obj = compile(
|
||||||
|
self.wrap_expression(expression_source, param_keys), self._filename, "exec",
|
||||||
|
)
|
||||||
|
try:
|
||||||
|
_locals = self._context
|
||||||
|
# Yes this is an exec, yes it is potentially bad. Since we limit what variables are
|
||||||
|
# available here, and these policies can only be edited by admins, this is a risk
|
||||||
|
# we're willing to take.
|
||||||
|
# pylint: disable=exec-used
|
||||||
|
exec(ast_obj, self._globals, _locals) # nosec # noqa
|
||||||
|
result = _locals["result"]
|
||||||
|
except Exception as exc:
|
||||||
|
LOGGER.warning("Expression error", exc=exc)
|
||||||
|
raise
|
||||||
|
return result
|
||||||
|
|
||||||
|
def validate(self, expression: str) -> bool:
|
||||||
|
"""Validate expression's syntax, raise ValidationError if Syntax is invalid"""
|
||||||
|
param_keys = self._context.keys()
|
||||||
|
try:
|
||||||
|
compile(
|
||||||
|
self.wrap_expression(expression, param_keys), self._filename, "exec",
|
||||||
|
)
|
||||||
|
return True
|
||||||
|
except (ValueError, SyntaxError) as exc:
|
||||||
|
raise ValidationError(f"Expression Syntax Error: {str(exc)}") from exc
|
|
@ -1,81 +1,30 @@
|
||||||
"""passbook expression policy evaluator"""
|
"""passbook expression policy evaluator"""
|
||||||
import re
|
from typing import List
|
||||||
from typing import Any, Dict, List, Optional
|
|
||||||
|
|
||||||
from django.core.exceptions import ValidationError
|
|
||||||
from django.http import HttpRequest
|
from django.http import HttpRequest
|
||||||
from jinja2 import Undefined
|
|
||||||
from jinja2.exceptions import TemplateSyntaxError
|
|
||||||
from jinja2.nativetypes import NativeEnvironment
|
|
||||||
from requests import Session
|
|
||||||
from structlog import get_logger
|
from structlog import get_logger
|
||||||
|
|
||||||
from passbook.core.models import User
|
|
||||||
from passbook.flows.planner import PLAN_CONTEXT_SSO
|
from passbook.flows.planner import PLAN_CONTEXT_SSO
|
||||||
from passbook.flows.views import SESSION_KEY_PLAN
|
from passbook.flows.views import SESSION_KEY_PLAN
|
||||||
|
from passbook.lib.expression.evaluator import BaseEvaluator
|
||||||
from passbook.lib.utils.http import get_client_ip
|
from passbook.lib.utils.http import get_client_ip
|
||||||
from passbook.policies.types import PolicyRequest, PolicyResult
|
from passbook.policies.types import PolicyRequest, PolicyResult
|
||||||
|
|
||||||
LOGGER = get_logger()
|
LOGGER = get_logger()
|
||||||
|
|
||||||
|
|
||||||
class Evaluator:
|
class PolicyEvaluator(BaseEvaluator):
|
||||||
"""Validate and evaluate jinja2-based expressions"""
|
"""Validate and evaluate python-based expressions"""
|
||||||
|
|
||||||
_env: NativeEnvironment
|
|
||||||
|
|
||||||
_context: Dict[str, Any]
|
|
||||||
_messages: List[str]
|
_messages: List[str]
|
||||||
|
|
||||||
def __init__(self):
|
def __init__(self, policy_name: str):
|
||||||
self._env = NativeEnvironment(
|
super().__init__()
|
||||||
extensions=["jinja2.ext.do"],
|
|
||||||
trim_blocks=True,
|
|
||||||
lstrip_blocks=True,
|
|
||||||
line_statement_prefix=">",
|
|
||||||
)
|
|
||||||
# update passbook/policies/expression/templates/policy/expression/form.html
|
|
||||||
# update docs/policies/expression/index.md
|
|
||||||
self._env.filters["regex_match"] = Evaluator.jinja2_filter_regex_match
|
|
||||||
self._env.filters["regex_replace"] = Evaluator.jinja2_filter_regex_replace
|
|
||||||
self._env.globals["pb_message"] = self.jinja2_func_message
|
|
||||||
self._context = {
|
|
||||||
"pb_is_group_member": Evaluator.jinja2_func_is_group_member,
|
|
||||||
"pb_user_by": Evaluator.jinja2_func_user_by,
|
|
||||||
"pb_logger": get_logger(),
|
|
||||||
"requests": Session(),
|
|
||||||
}
|
|
||||||
self._messages = []
|
self._messages = []
|
||||||
|
self._context["pb_message"] = self.expr_func_message
|
||||||
|
self._filename = policy_name
|
||||||
|
|
||||||
@property
|
def expr_func_message(self, message: str):
|
||||||
def env(self) -> NativeEnvironment:
|
|
||||||
"""Access to our custom NativeEnvironment"""
|
|
||||||
return self._env
|
|
||||||
|
|
||||||
@staticmethod
|
|
||||||
def jinja2_filter_regex_match(value: Any, regex: str) -> bool:
|
|
||||||
"""Jinja2 Filter to run re.search"""
|
|
||||||
return re.search(regex, value) is None
|
|
||||||
|
|
||||||
@staticmethod
|
|
||||||
def jinja2_filter_regex_replace(value: Any, regex: str, repl: str) -> str:
|
|
||||||
"""Jinja2 Filter to run re.sub"""
|
|
||||||
return re.sub(regex, repl, value)
|
|
||||||
|
|
||||||
@staticmethod
|
|
||||||
def jinja2_func_user_by(**filters) -> Optional[User]:
|
|
||||||
"""Get user by filters"""
|
|
||||||
users = User.objects.filter(**filters)
|
|
||||||
if users:
|
|
||||||
return users.first()
|
|
||||||
return None
|
|
||||||
|
|
||||||
@staticmethod
|
|
||||||
def jinja2_func_is_group_member(user: User, group_name: str) -> bool:
|
|
||||||
"""Check if `user` is member of group with name `group_name`"""
|
|
||||||
return user.groups.filter(name=group_name).exists()
|
|
||||||
|
|
||||||
def jinja2_func_message(self, message: str):
|
|
||||||
"""Wrapper to append to messages list, which is returned with PolicyResult"""
|
"""Wrapper to append to messages list, which is returned with PolicyResult"""
|
||||||
self._messages.append(message)
|
self._messages.append(message)
|
||||||
|
|
||||||
|
@ -84,41 +33,35 @@ class Evaluator:
|
||||||
# update passbook/policies/expression/templates/policy/expression/form.html
|
# update passbook/policies/expression/templates/policy/expression/form.html
|
||||||
# update docs/policies/expression/index.md
|
# update docs/policies/expression/index.md
|
||||||
self._context["pb_is_sso_flow"] = request.context.get(PLAN_CONTEXT_SSO, False)
|
self._context["pb_is_sso_flow"] = request.context.get(PLAN_CONTEXT_SSO, False)
|
||||||
self._context["request"] = request
|
|
||||||
if request.http_request:
|
if request.http_request:
|
||||||
self.set_http_request(request.http_request)
|
self.set_http_request(request.http_request)
|
||||||
|
self._context["request"] = request
|
||||||
|
|
||||||
def set_http_request(self, request: HttpRequest):
|
def set_http_request(self, request: HttpRequest):
|
||||||
"""Update context based on http request"""
|
"""Update context based on http request"""
|
||||||
# update passbook/policies/expression/templates/policy/expression/form.html
|
# update passbook/policies/expression/templates/policy/expression/form.html
|
||||||
# update docs/policies/expression/index.md
|
# update docs/policies/expression/index.md
|
||||||
self._context["pb_client_ip"] = (
|
self._context["pb_client_ip"] = get_client_ip(request) or "255.255.255.255"
|
||||||
get_client_ip(request.http_request) or "255.255.255.255"
|
|
||||||
)
|
|
||||||
self._context["request"] = request
|
self._context["request"] = request
|
||||||
if SESSION_KEY_PLAN in request.http_request.session:
|
if SESSION_KEY_PLAN in request.session:
|
||||||
self._context["pb_flow_plan"] = request.http_request.session[
|
self._context["pb_flow_plan"] = request.session[SESSION_KEY_PLAN]
|
||||||
SESSION_KEY_PLAN
|
|
||||||
]
|
|
||||||
|
|
||||||
def evaluate(self, expression_source: str) -> PolicyResult:
|
def evaluate(self, expression_source: str) -> PolicyResult:
|
||||||
"""Parse and evaluate expression. Policy is expected to return a truthy object.
|
"""Parse and evaluate expression. Policy is expected to return a truthy object.
|
||||||
Messages can be added using 'do pb_message()'."""
|
Messages can be added using 'do pb_message()'."""
|
||||||
try:
|
try:
|
||||||
expression = self._env.from_string(expression_source.lstrip().rstrip())
|
result = super().evaluate(expression_source)
|
||||||
except TemplateSyntaxError as exc:
|
except (ValueError, SyntaxError) as exc:
|
||||||
return PolicyResult(False, str(exc))
|
return PolicyResult(False, str(exc))
|
||||||
try:
|
|
||||||
result: Optional[Any] = expression.render(self._context)
|
|
||||||
except Exception as exc: # pylint: disable=broad-except
|
except Exception as exc: # pylint: disable=broad-except
|
||||||
LOGGER.warning("Expression error", exc=exc)
|
LOGGER.warning("Expression error", exc=exc)
|
||||||
return PolicyResult(False, str(exc))
|
return PolicyResult(False, str(exc))
|
||||||
else:
|
else:
|
||||||
policy_result = PolicyResult(False)
|
policy_result = PolicyResult(False)
|
||||||
policy_result.messages = tuple(self._messages)
|
policy_result.messages = tuple(self._messages)
|
||||||
if isinstance(result, Undefined):
|
if result is None:
|
||||||
LOGGER.warning(
|
LOGGER.warning(
|
||||||
"Expression policy returned undefined",
|
"Expression policy returned None",
|
||||||
src=expression_source,
|
src=expression_source,
|
||||||
req=self._context,
|
req=self._context,
|
||||||
)
|
)
|
||||||
|
@ -126,11 +69,3 @@ class Evaluator:
|
||||||
if result:
|
if result:
|
||||||
policy_result.passing = bool(result)
|
policy_result.passing = bool(result)
|
||||||
return policy_result
|
return policy_result
|
||||||
|
|
||||||
def validate(self, expression: str):
|
|
||||||
"""Validate expression's syntax, raise ValidationError if Syntax is invalid"""
|
|
||||||
try:
|
|
||||||
self._env.from_string(expression)
|
|
||||||
return True
|
|
||||||
except TemplateSyntaxError as exc:
|
|
||||||
raise ValidationError(f"Expression Syntax Error: {str(exc)}") from exc
|
|
||||||
|
|
|
@ -3,7 +3,7 @@
|
||||||
from django import forms
|
from django import forms
|
||||||
|
|
||||||
from passbook.admin.fields import CodeMirrorWidget
|
from passbook.admin.fields import CodeMirrorWidget
|
||||||
from passbook.policies.expression.evaluator import Evaluator
|
from passbook.policies.expression.evaluator import PolicyEvaluator
|
||||||
from passbook.policies.expression.models import ExpressionPolicy
|
from passbook.policies.expression.models import ExpressionPolicy
|
||||||
from passbook.policies.forms import GENERAL_FIELDS
|
from passbook.policies.forms import GENERAL_FIELDS
|
||||||
|
|
||||||
|
@ -14,9 +14,9 @@ class ExpressionPolicyForm(forms.ModelForm):
|
||||||
template_name = "policy/expression/form.html"
|
template_name = "policy/expression/form.html"
|
||||||
|
|
||||||
def clean_expression(self):
|
def clean_expression(self):
|
||||||
"""Test Jinja2 Syntax"""
|
"""Test Syntax"""
|
||||||
expression = self.cleaned_data.get("expression")
|
expression = self.cleaned_data.get("expression")
|
||||||
Evaluator().validate(expression)
|
PolicyEvaluator(self.instance.name).validate(expression)
|
||||||
return expression
|
return expression
|
||||||
|
|
||||||
class Meta:
|
class Meta:
|
||||||
|
@ -27,5 +27,5 @@ class ExpressionPolicyForm(forms.ModelForm):
|
||||||
]
|
]
|
||||||
widgets = {
|
widgets = {
|
||||||
"name": forms.TextInput(),
|
"name": forms.TextInput(),
|
||||||
"expression": CodeMirrorWidget(mode="jinja2"),
|
"expression": CodeMirrorWidget(mode="python"),
|
||||||
}
|
}
|
||||||
|
|
|
@ -2,13 +2,13 @@
|
||||||
from django.db import models
|
from django.db import models
|
||||||
from django.utils.translation import gettext as _
|
from django.utils.translation import gettext as _
|
||||||
|
|
||||||
from passbook.policies.expression.evaluator import Evaluator
|
from passbook.policies.expression.evaluator import PolicyEvaluator
|
||||||
from passbook.policies.models import Policy
|
from passbook.policies.models import Policy
|
||||||
from passbook.policies.types import PolicyRequest, PolicyResult
|
from passbook.policies.types import PolicyRequest, PolicyResult
|
||||||
|
|
||||||
|
|
||||||
class ExpressionPolicy(Policy):
|
class ExpressionPolicy(Policy):
|
||||||
"""Jinja2-based Expression policy that allows Admins to write their own logic"""
|
"""Implement custom logic using python."""
|
||||||
|
|
||||||
expression = models.TextField()
|
expression = models.TextField()
|
||||||
|
|
||||||
|
@ -16,12 +16,12 @@ class ExpressionPolicy(Policy):
|
||||||
|
|
||||||
def passes(self, request: PolicyRequest) -> PolicyResult:
|
def passes(self, request: PolicyRequest) -> PolicyResult:
|
||||||
"""Evaluate and render expression. Returns PolicyResult(false) on error."""
|
"""Evaluate and render expression. Returns PolicyResult(false) on error."""
|
||||||
evaluator = Evaluator()
|
evaluator = PolicyEvaluator(self.name)
|
||||||
evaluator.set_policy_request(request)
|
evaluator.set_policy_request(request)
|
||||||
return evaluator.evaluate(self.expression)
|
return evaluator.evaluate(self.expression)
|
||||||
|
|
||||||
def save(self, *args, **kwargs):
|
def save(self, *args, **kwargs):
|
||||||
Evaluator().validate(self.expression)
|
PolicyEvaluator(self.name).validate(self.expression)
|
||||||
return super().save(*args, **kwargs)
|
return super().save(*args, **kwargs)
|
||||||
|
|
||||||
class Meta:
|
class Meta:
|
||||||
|
|
|
@ -3,7 +3,7 @@ from django.core.exceptions import ValidationError
|
||||||
from django.test import TestCase
|
from django.test import TestCase
|
||||||
from guardian.shortcuts import get_anonymous_user
|
from guardian.shortcuts import get_anonymous_user
|
||||||
|
|
||||||
from passbook.policies.expression.evaluator import Evaluator
|
from passbook.policies.expression.evaluator import PolicyEvaluator
|
||||||
from passbook.policies.types import PolicyRequest
|
from passbook.policies.types import PolicyRequest
|
||||||
|
|
||||||
|
|
||||||
|
@ -15,15 +15,15 @@ class TestEvaluator(TestCase):
|
||||||
|
|
||||||
def test_valid(self):
|
def test_valid(self):
|
||||||
"""test simple value expression"""
|
"""test simple value expression"""
|
||||||
template = "True"
|
template = "return True"
|
||||||
evaluator = Evaluator()
|
evaluator = PolicyEvaluator("test")
|
||||||
evaluator.set_policy_request(self.request)
|
evaluator.set_policy_request(self.request)
|
||||||
self.assertEqual(evaluator.evaluate(template).passing, True)
|
self.assertEqual(evaluator.evaluate(template).passing, True)
|
||||||
|
|
||||||
def test_messages(self):
|
def test_messages(self):
|
||||||
"""test expression with message return"""
|
"""test expression with message return"""
|
||||||
template = '{% do pb_message("some message") %}False'
|
template = 'pb_message("some message");return False'
|
||||||
evaluator = Evaluator()
|
evaluator = PolicyEvaluator("test")
|
||||||
evaluator.set_policy_request(self.request)
|
evaluator.set_policy_request(self.request)
|
||||||
result = evaluator.evaluate(template)
|
result = evaluator.evaluate(template)
|
||||||
self.assertEqual(result.passing, False)
|
self.assertEqual(result.passing, False)
|
||||||
|
@ -31,32 +31,32 @@ class TestEvaluator(TestCase):
|
||||||
|
|
||||||
def test_invalid_syntax(self):
|
def test_invalid_syntax(self):
|
||||||
"""test invalid syntax"""
|
"""test invalid syntax"""
|
||||||
template = "{%"
|
template = ";"
|
||||||
evaluator = Evaluator()
|
evaluator = PolicyEvaluator("test")
|
||||||
evaluator.set_policy_request(self.request)
|
evaluator.set_policy_request(self.request)
|
||||||
result = evaluator.evaluate(template)
|
result = evaluator.evaluate(template)
|
||||||
self.assertEqual(result.passing, False)
|
self.assertEqual(result.passing, False)
|
||||||
self.assertEqual(result.messages, ("tag name expected",))
|
self.assertEqual(result.messages, ("invalid syntax (test, line 2)",))
|
||||||
|
|
||||||
def test_undefined(self):
|
def test_undefined(self):
|
||||||
"""test undefined result"""
|
"""test undefined result"""
|
||||||
template = "{{ foo.bar }}"
|
template = "{{ foo.bar }}"
|
||||||
evaluator = Evaluator()
|
evaluator = PolicyEvaluator("test")
|
||||||
evaluator.set_policy_request(self.request)
|
evaluator.set_policy_request(self.request)
|
||||||
result = evaluator.evaluate(template)
|
result = evaluator.evaluate(template)
|
||||||
self.assertEqual(result.passing, False)
|
self.assertEqual(result.passing, False)
|
||||||
self.assertEqual(result.messages, ("'foo' is undefined",))
|
self.assertEqual(result.messages, ("name 'foo' is not defined",))
|
||||||
|
|
||||||
def test_validate(self):
|
def test_validate(self):
|
||||||
"""test validate"""
|
"""test validate"""
|
||||||
template = "True"
|
template = "True"
|
||||||
evaluator = Evaluator()
|
evaluator = PolicyEvaluator("test")
|
||||||
result = evaluator.validate(template)
|
result = evaluator.validate(template)
|
||||||
self.assertEqual(result, True)
|
self.assertEqual(result, True)
|
||||||
|
|
||||||
def test_validate_invalid(self):
|
def test_validate_invalid(self):
|
||||||
"""test validate"""
|
"""test validate"""
|
||||||
template = "{%"
|
template = ";"
|
||||||
evaluator = Evaluator()
|
evaluator = PolicyEvaluator("test")
|
||||||
with self.assertRaises(ValidationError):
|
with self.assertRaises(ValidationError):
|
||||||
evaluator.validate(template)
|
evaluator.validate(template)
|
||||||
|
|
|
@ -39,6 +39,8 @@ class PolicyProcess(Process):
|
||||||
super().__init__()
|
super().__init__()
|
||||||
self.binding = binding
|
self.binding = binding
|
||||||
self.request = request
|
self.request = request
|
||||||
|
if not isinstance(self.request, PolicyRequest):
|
||||||
|
raise ValueError(f"{self.request} is not a Policy Request.")
|
||||||
if connection:
|
if connection:
|
||||||
self.connection = connection
|
self.connection = connection
|
||||||
|
|
||||||
|
|
|
@ -4,6 +4,7 @@ from django import forms
|
||||||
from django.contrib.admin.widgets import FilteredSelectMultiple
|
from django.contrib.admin.widgets import FilteredSelectMultiple
|
||||||
from django.utils.translation import gettext as _
|
from django.utils.translation import gettext as _
|
||||||
|
|
||||||
|
from passbook.core.expression import PropertyMappingEvaluator
|
||||||
from passbook.providers.saml.models import (
|
from passbook.providers.saml.models import (
|
||||||
SAMLPropertyMapping,
|
SAMLPropertyMapping,
|
||||||
SAMLProvider,
|
SAMLProvider,
|
||||||
|
@ -52,6 +53,13 @@ class SAMLPropertyMappingForm(forms.ModelForm):
|
||||||
|
|
||||||
template_name = "saml/idp/property_mapping_form.html"
|
template_name = "saml/idp/property_mapping_form.html"
|
||||||
|
|
||||||
|
def clean_expression(self):
|
||||||
|
"""Test Syntax"""
|
||||||
|
expression = self.cleaned_data.get("expression")
|
||||||
|
evaluator = PropertyMappingEvaluator()
|
||||||
|
evaluator.validate(expression)
|
||||||
|
return expression
|
||||||
|
|
||||||
class Meta:
|
class Meta:
|
||||||
|
|
||||||
model = SAMLPropertyMapping
|
model = SAMLPropertyMapping
|
||||||
|
|
|
@ -13,27 +13,27 @@ def create_default_property_mappings(apps, schema_editor):
|
||||||
{
|
{
|
||||||
"FriendlyName": "eduPersonPrincipalName",
|
"FriendlyName": "eduPersonPrincipalName",
|
||||||
"Name": "urn:oid:1.3.6.1.4.1.5923.1.1.1.6",
|
"Name": "urn:oid:1.3.6.1.4.1.5923.1.1.1.6",
|
||||||
"Expression": "{{ user.email }}",
|
"Expression": "return user.get('email')",
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"FriendlyName": "cn",
|
"FriendlyName": "cn",
|
||||||
"Name": "urn:oid:2.5.4.3",
|
"Name": "urn:oid:2.5.4.3",
|
||||||
"Expression": "{{ user.name }}",
|
"Expression": "return user.get('name')",
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"FriendlyName": "mail",
|
"FriendlyName": "mail",
|
||||||
"Name": "urn:oid:0.9.2342.19200300.100.1.3",
|
"Name": "urn:oid:0.9.2342.19200300.100.1.3",
|
||||||
"Expression": "{{ user.email }}",
|
"Expression": "return user.get('email')",
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"FriendlyName": "displayName",
|
"FriendlyName": "displayName",
|
||||||
"Name": "urn:oid:2.16.840.1.113730.3.1.241",
|
"Name": "urn:oid:2.16.840.1.113730.3.1.241",
|
||||||
"Expression": "{{ user.username }}",
|
"Expression": "return user.get('username')",
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"FriendlyName": "uid",
|
"FriendlyName": "uid",
|
||||||
"Name": "urn:oid:0.9.2342.19200300.100.1.1",
|
"Name": "urn:oid:0.9.2342.19200300.100.1.1",
|
||||||
"Expression": "{{ user.pk }}",
|
"Expression": "return user.get('pk')",
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"FriendlyName": "member-of",
|
"FriendlyName": "member-of",
|
||||||
|
|
|
@ -1,4 +1,5 @@
|
||||||
"""Basic SAML Processor"""
|
"""Basic SAML Processor"""
|
||||||
|
from types import GeneratorType
|
||||||
from typing import TYPE_CHECKING, Dict, List, Union
|
from typing import TYPE_CHECKING, Dict, List, Union
|
||||||
|
|
||||||
from cryptography.exceptions import InvalidSignature
|
from cryptography.exceptions import InvalidSignature
|
||||||
|
@ -21,7 +22,7 @@ if TYPE_CHECKING:
|
||||||
|
|
||||||
# pylint: disable=too-many-instance-attributes
|
# pylint: disable=too-many-instance-attributes
|
||||||
class Processor:
|
class Processor:
|
||||||
"""Base SAML 2.0 AuthnRequest to Response Processor.
|
"""Base SAML 2.0 Auth-N-Request to Response Processor.
|
||||||
Sub-classes should provide Service Provider-specific functionality."""
|
Sub-classes should provide Service Provider-specific functionality."""
|
||||||
|
|
||||||
is_idp_initiated = False
|
is_idp_initiated = False
|
||||||
|
@ -111,6 +112,8 @@ class Processor:
|
||||||
request=self._http_request,
|
request=self._http_request,
|
||||||
provider=self._remote,
|
provider=self._remote,
|
||||||
)
|
)
|
||||||
|
if value is None:
|
||||||
|
continue
|
||||||
mapping_payload = {
|
mapping_payload = {
|
||||||
"Name": mapping.saml_name,
|
"Name": mapping.saml_name,
|
||||||
"FriendlyName": mapping.friendly_name,
|
"FriendlyName": mapping.friendly_name,
|
||||||
|
@ -119,6 +122,8 @@ class Processor:
|
||||||
# differently in the template
|
# differently in the template
|
||||||
if isinstance(value, list):
|
if isinstance(value, list):
|
||||||
mapping_payload["ValueArray"] = value
|
mapping_payload["ValueArray"] = value
|
||||||
|
elif isinstance(value, GeneratorType):
|
||||||
|
mapping_payload["ValueArray"] = list(value)
|
||||||
else:
|
else:
|
||||||
mapping_payload["Value"] = value
|
mapping_payload["Value"] = value
|
||||||
attributes.append(mapping_payload)
|
attributes.append(mapping_payload)
|
||||||
|
|
|
@ -164,9 +164,10 @@ class Connector:
|
||||||
continue
|
continue
|
||||||
mapping: LDAPPropertyMapping
|
mapping: LDAPPropertyMapping
|
||||||
try:
|
try:
|
||||||
properties[mapping.object_field] = mapping.evaluate(
|
value = mapping.evaluate(user=None, request=None, ldap=attributes)
|
||||||
user=None, request=None, ldap=attributes
|
if value is None:
|
||||||
)
|
continue
|
||||||
|
properties[mapping.object_field] = value
|
||||||
except PropertyMappingExpressionException as exc:
|
except PropertyMappingExpressionException as exc:
|
||||||
LOGGER.warning("Mapping failed to evaluate", exc=exc, mapping=mapping)
|
LOGGER.warning("Mapping failed to evaluate", exc=exc, mapping=mapping)
|
||||||
continue
|
continue
|
||||||
|
|
|
@ -5,6 +5,7 @@ from django.contrib.admin.widgets import FilteredSelectMultiple
|
||||||
from django.utils.translation import gettext_lazy as _
|
from django.utils.translation import gettext_lazy as _
|
||||||
|
|
||||||
from passbook.admin.forms.source import SOURCE_FORM_FIELDS
|
from passbook.admin.forms.source import SOURCE_FORM_FIELDS
|
||||||
|
from passbook.core.expression import PropertyMappingEvaluator
|
||||||
from passbook.sources.ldap.models import LDAPPropertyMapping, LDAPSource
|
from passbook.sources.ldap.models import LDAPPropertyMapping, LDAPSource
|
||||||
|
|
||||||
|
|
||||||
|
@ -52,6 +53,13 @@ class LDAPPropertyMappingForm(forms.ModelForm):
|
||||||
|
|
||||||
template_name = "ldap/property_mapping_form.html"
|
template_name = "ldap/property_mapping_form.html"
|
||||||
|
|
||||||
|
def clean_expression(self):
|
||||||
|
"""Test Syntax"""
|
||||||
|
expression = self.cleaned_data.get("expression")
|
||||||
|
evaluator = PropertyMappingEvaluator()
|
||||||
|
evaluator.validate(expression)
|
||||||
|
return expression
|
||||||
|
|
||||||
class Meta:
|
class Meta:
|
||||||
|
|
||||||
model = LDAPPropertyMapping
|
model = LDAPPropertyMapping
|
||||||
|
|
|
@ -7,11 +7,11 @@ from django.db import migrations
|
||||||
def create_default_ad_property_mappings(apps: Apps, schema_editor):
|
def create_default_ad_property_mappings(apps: Apps, schema_editor):
|
||||||
LDAPPropertyMapping = apps.get_model("passbook_sources_ldap", "LDAPPropertyMapping")
|
LDAPPropertyMapping = apps.get_model("passbook_sources_ldap", "LDAPPropertyMapping")
|
||||||
mapping = {
|
mapping = {
|
||||||
"name": "{{ ldap.name }}",
|
"name": "return ldap.get('name')",
|
||||||
"first_name": "{{ ldap.givenName }}",
|
"first_name": "return ldap.get('givenName')",
|
||||||
"last_name": "{{ ldap.sn }}",
|
"last_name": "return ldap.get('sn')",
|
||||||
"username": "{{ ldap.sAMAccountName }}",
|
"username": "return ldap.get('sAMAccountName')",
|
||||||
"email": "{{ ldap.mail }}",
|
"email": "return ldap.get('mail')",
|
||||||
}
|
}
|
||||||
db_alias = schema_editor.connection.alias
|
db_alias = schema_editor.connection.alias
|
||||||
for object_field, expression in mapping.items():
|
for object_field, expression in mapping.items():
|
||||||
|
|
|
@ -45,6 +45,19 @@ class TestEmailStage(TestCase):
|
||||||
response = self.client.get(url)
|
response = self.client.get(url)
|
||||||
self.assertEqual(response.status_code, 200)
|
self.assertEqual(response.status_code, 200)
|
||||||
|
|
||||||
|
def test_without_user(self):
|
||||||
|
"""Test without pending user"""
|
||||||
|
plan = FlowPlan(flow_pk=self.flow.pk.hex, stages=[self.stage])
|
||||||
|
session = self.client.session
|
||||||
|
session[SESSION_KEY_PLAN] = plan
|
||||||
|
session.save()
|
||||||
|
|
||||||
|
url = reverse(
|
||||||
|
"passbook_flows:flow-executor", kwargs={"flow_slug": self.flow.slug}
|
||||||
|
)
|
||||||
|
response = self.client.get(url)
|
||||||
|
self.assertEqual(response.status_code, 200)
|
||||||
|
|
||||||
def test_pending_user(self):
|
def test_pending_user(self):
|
||||||
"""Test with pending user"""
|
"""Test with pending user"""
|
||||||
plan = FlowPlan(flow_pk=self.flow.pk.hex, stages=[self.stage])
|
plan = FlowPlan(flow_pk=self.flow.pk.hex, stages=[self.stage])
|
||||||
|
|
|
@ -111,12 +111,10 @@ class TestPromptStage(TestCase):
|
||||||
self.assertIn(prompt.label, response.rendered_content)
|
self.assertIn(prompt.label, response.rendered_content)
|
||||||
self.assertIn(prompt.placeholder, response.rendered_content)
|
self.assertIn(prompt.placeholder, response.rendered_content)
|
||||||
|
|
||||||
def test_valid_form(self) -> PromptForm:
|
def test_valid_form_with_policy(self) -> PromptForm:
|
||||||
"""Test form validation"""
|
"""Test form validation"""
|
||||||
plan = FlowPlan(flow_pk=self.flow.pk.hex, stages=[self.stage])
|
plan = FlowPlan(flow_pk=self.flow.pk.hex, stages=[self.stage])
|
||||||
expr = (
|
expr = "return request.context['password_prompt'] == request.context['password2_prompt']"
|
||||||
"{{ request.context.password_prompt == request.context.password2_prompt }}"
|
|
||||||
)
|
|
||||||
expr_policy = ExpressionPolicy.objects.create(
|
expr_policy = ExpressionPolicy.objects.create(
|
||||||
name="validate-form", expression=expr
|
name="validate-form", expression=expr
|
||||||
)
|
)
|
||||||
|
@ -144,7 +142,7 @@ class TestPromptStage(TestCase):
|
||||||
session[SESSION_KEY_PLAN] = plan
|
session[SESSION_KEY_PLAN] = plan
|
||||||
session.save()
|
session.save()
|
||||||
|
|
||||||
form = self.test_valid_form()
|
form = self.test_valid_form_with_policy()
|
||||||
|
|
||||||
with patch("passbook.flows.views.FlowExecutorView.cancel", MagicMock()):
|
with patch("passbook.flows.views.FlowExecutorView.cancel", MagicMock()):
|
||||||
response = self.client.post(
|
response = self.client.post(
|
||||||
|
|
Reference in New Issue