path: root/python-spkcspider.spec

%global _empty_manifest_terminate_build 0
Name:		python-spkcspider
Version:	0.30
Release:	1
Summary:	A secure, decentral platform for maintaining your online identity
License:	MIT
URL:		https://spkcspider.net
Source0:	https://mirrors.aliyun.com/pypi/web/packages/4b/03/652291261dcfbe8fe39228690a52539cc0e2f24391246c3dfe2e0e502de1/spkcspider-0.30.tar.gz
BuildArch:	noarch

Requires:	python3-django
Requires:	python3-django-simple-jsonfield
Requires:	python3-requests
Requires:	python3-certifi
Requires:	python3-bleach
Requires:	python3-rdflib
Requires:	python3-html5lib
Requires:	python3-cryptography
Requires:	python3-django-ranged-response
Requires:	python3-django-widget-tweaks
Requires:	python3-django-next-prev
Requires:	python3-django-fast-ratelimit
Requires:	python3-django-simple-captcha
Requires:	python3-flipflop
Requires:	python3-mysqlclient
Requires:	python3-django-mysql
Requires:	python3-psycopg2
Requires:	python3-celery
Requires:	python3-sqlalchemy
Requires:	python3-spkcspider-domainauth
Requires:	python3-django-webtest
Requires:	python3-WSGIProxy2

%description
spkcspider provides a digital visiting card which can e.g. be used for authentication, shopping and payment. For this a multifactor authentication is provided.
It keeps your online data safe while shopping by just providing a link to a potion of your data. Doing this, the user may can provide some knocking mechanism (e.g. has to provide some code, tan) to protect the content.
Further features and advantages of spkcspider are:
* cross device configuration without saving user data on webshop/service.
  This makes them easily DSGVO compatible without adjustments
* Address Data have to changed only on one place if you move. This is especially useful if you move a lot
  Also if you travel and want to buy something on the way.
* Verification of data is possible.
* Privacy: private servers are easily set up (only requirement: cgi), also compatible to tor
* Travelling: some people don't respect common rules for privacy. This tool allows you to keep your digital life private.
  * You don't have it on the device
  * You can hide your data with the travel mode (against the worst kind of inspectors)
    * Note: traces could be still existent (like "recently-used" feature, bookmarks)
  * for governments: use psychology instead of breaking into systems! The only victims are law-abidding citizens.
# Installation
This project can either be used as a standalone project (clone repo) or as a set of reusable apps (setup.py installation).
## Build Requirements
* npm
* pip >=19 (and poetry)
## Poetry (within virtual environment)
~~~~ sh
poetry install
# for installing with extras specify -E extra1 -E extra2
~~~~
## Pip
~~~~ sh
pip install .
~~~~
## Setup
~~~~ sh
npm install --no-save
./manager.py migrate
./manager.py collectstatic
# or simply use
./tools/install_deps.sh
~~~~
## Caveats
allow_domain_mode NULL errors:
some migration failed and now it is neccessary to redo them manually
connect to database and execute:
ALTER TABLE spider_base_usercomponent DROP COLUMN allow_domain_mode;
ALTER TABLE spider_base_assignedcontent DROP COLUMN allow_domain_mode;
this doesn't work in sqlite3 (
  export data (and remove allow_domain_mode if specified)
  recreate db file
  import data
  see: http://www.sqlitetutorial.net/sqlite-alter-table/ why you don't want to try it manually
)
Mysql works with some special settings:
Require mysql to use utf8 charset
To unbreak tests, use 'CHARSET': 'utf8':
~~~~ python
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'TEST': {
            'CHARSET': 'utf8'
        }
    }
}
~~~~
### Possibilities how to add utf8 charset to mysql:
* use 'read_default_file' and add "default-character-set = utf8" in config
* create database with "CHARACTER SET utf8"
* see: https://docs.djangoproject.com/en/dev/ref/databases/#mysql-notes
### \_\_old crashes object creation:
downgrade sqlite3 to 3.25 or upgrade django to at least 2.1.5/2.0.10
importing data:
set:
UPDATE_DYNAMIC_AFTER_MIGRATION = False
before importing data (with loaddata), update dynamic creates data
### keep pathes if switching from cgi
~~~~
location /cgi-bin/cgihandler.fcgi {
   rewrite /cgi-bin/cgihandler.fcgi/?(.*)$ https://new.spkcspider.net/$1 redirect ;
}
~~~~
### logging
In this model tokens are transferred as GET parameters. Consider disabling the
logging of GET parameters (at least the sensible ones) or better:
disable logging of succeeding requests
nginx filter tokens only (hard):
~~~~
location / {
  set $filtered_request $request;
  if ($filtered_request ~ (.*)token=[^&]*(.*)) {
      set $filtered_request $1token=****$2;
  }
}
log_format filtered_combined '$remote_addr - $remote_user [$time_local] '
                    '"$filtered_request" $status $body_bytes_sent '
                    '"$http_referer" "$http_user_agent"';
access_log /var/logs/nginx-access.log filtered_combined;
~~~~
nginx filter GET parameters:
~~~~
log_format filtered_combined '$remote_addr - $remote_user [$time_local] '
                    '"$uri" $status $body_bytes_sent '
                    '"$http_referer" "$http_user_agent"';
access_log /var/logs/nginx-access.log filtered_combined;
~~~~
apache filter GET parameters:
~~~~
LogFormat "%h %l %u %t \"%m %U %H\" %>s %b \"%{Referer}i\" \"%{User-agent}i\"" combined
~~~~
### localization
Don't use path based localization! This breaks the whole model.
Pathes should be unique for validation. Localisation in curl requests
can be archieved by headers.
# External usage
There are special GET parameters for controlling spkcspider:
* page=<int>: page number
* token=xy: token as GET parameter, if invalid: retrieve token as GET parameter
* token=prefer: uses invalid mechanic, easier to see what it does
* raw=true: optimize output for machines, use turtle format
* raw=embed: embed content of components, use turtle format
* id=id&id=id: limit content ids (Content lists only)
* search=foo&search=!notfoo: search case insensitive a string
* search=\_unlisted: List "unlisted" content if owner, special user (doesn't work in public list).
* protection=false: fail if protections are required
* protection=xy&protection=yx...: protections to use
* intention=auth: try to login with UserComponent authentication (falls back to login redirect)
* referrer=<url>: activate referrer mode
  * intention=domain: domain verify referrer mode
  * intention=sl: server-less referrer mode
  * payload=<foo>: passed on successful requests (including post), e.g. for sessionid
  * intention=login: referrer uses spkcspider for login (note: referrer should be the one where the user is logging in, check referrer field for that)
  * intention=persist: referrer can persist data on webserver
* embed_big=true: only for staff and superuser: Overrides maximal size of files which are embedded in graphs (only for default helper)
## special header
* Content-Type/Accept=application/json: some forms are rendered as json (currently only deletion form)
## Referrer
* normal referrer mode: send token to referrer, client verifies with hash that he sent the token.
* server-less referrer mode (sl): token is transferred as GET parameter and no POST request is made (less secure as client sees token and client is not authenticated)
* domain referrer mode (domain): referrer domain is add to token. Doesn't work with other intentions (but "live" mode is active as no filter will be created) and works only if domain_mode is for context active (e.g. feature or access context (content)). Can be automated, doesn't require user approval. Useful for tag updates (only active if feature requests domain mode).
### special intentions:
* sl: activates server less mode
* live: filter live instead using fixed ids
## search parameters
* search also searches UserComponents name and description fields
* can only be used with "list"-views
* items can be negated with !foo
* strict infofield search can be activated with \_
* !!foo escapes a !foo item
* \_\_foo escapes a \_foo item
* !\_ negates a strict infofield search
* \_unlisted is a special search: it lists with "unlisted" marked contents
verified_by urls should return last verification date for a hash
## raw mode
raw mode can follow references even in other components because it is readonly.
Otherwise security could be compromised.
## Important Features
* Persistence: Allow referrer to save data (used and activated by persistent features)
* WebConfig: Allow remote websites and servers to save config data on your server (requires Persistence)
* TmpConfig: Allow remote websites and servers to save config data on your server, attached to temporary tokens (means: they are gone after a while)
# internal API
## Structure
### spider:
For spiders and contents
* spkcspider.apps.spider: store User Components, common base, WARNING: has spider_base namespace to not break existing apps
* spkcspider.apps.spider_accounts: user implementation suitable for the spiders. You can supply your own user model instead.
* spkcspider.apps.spider_filets: File and Text Content types
* spkcspider.apps.spider_keys: Public keys and anchors
* spkcspider.apps.spider_tags: verified information tags
* spkcspider.apps.spider_webcfg: WebConfig Feature
* spkcspider: contains spkcspider url detection and wsgi handler
### verifier:
Base reference implementation of a verifier.
spkcspider.apps.verifier: verifier base utils WARNING: has spider_verifier namespace to not break existing apps
## info field syntax
The info field is a simple key value storage. The syntax is (strip the spaces):
flag syntax: \\x1e key \\x1e
key value syntax: \\x1e key=value \\x1e
Note: I use the semantic ascii seperators \\x1e. Why? Sperating with an non-printable character eases escaping and sanitizing.
Note 2: I reverted from using \\x1f instead of = because the info field is used in searchs
Why not a json field? Django has no uniform json field for every db adapter yet.
## forms
* forms.initial: will be used for rdf
* field.initial: only for initialization
## authentication/privileges
* request.is_staff: requesting user used staff rights to access view (not true in ComponentPublicIndex)
* request.is_owner: requesting user owns the components
* request.is_special_user: requesting user owns the components or is_staff
* request.protections: int: enough protections were fullfilled, maximal measured strength, list: protections which failed, False: no access; access with protections not possible
## Special Scopes
* add: create content, with AssignedContent form
* update: update content
* raw_update: update Content, without AssignedContent form, adds second raw update mode (raw_add is not existent, can be archieved by returning HttpResponse in add scope)
* export: export data (import not implemented yet)
* view: present content to untrusted parties
## strength (component)
* 0: no protection. Complete content visible
* 1-3: protection strength which can be provided by protections. Meta data (names, descriptions) visible, inclusion in sitemap, public components
* 4: login only, user password. Still with inclusion of metadata
* 5: public attribute not set. No inclusion in sitemap or public components index anymore
* 6-8: protections + public attribute not set
* 9: login only, user password + public attribute not set
* 10: index, login only, special protected. Protections are used for login. Content here can be made unique per user by using unique per component attribute
= extra["strength"] on token (if available elsewise treat as zero):
the strength of the usercomponent for which it was created at the creation point
## strength (protection)
* 0: no protection
* 1-3: weak, medium, strong
* 4: do component authentication
= extra["prot_strength"] on token (if available elsewise treat as zero):
the strength of protections which was passed for creating the token
Note: access tokens created by admin have strength 0
## get usercomponent/content from url/urlpart for features
Use UserComponent.objects.from_url_part(url) / AssignedContent.from_url_part(url, [matchers]) for that
or use a domain_mode or persistent token.
Note: the difference between a domain_mode and a persistent token is, that the domain_mode token has a variable lifetime (user specific but defaults to 7 days)
Note: AssignedContent.objects.from_url_part(url) returns tuple: (matched feature/content, content which contains content/feature or None)
# API Breaks
* >0.5: settings rename\*\_ TLD_PARAMS_MAPPING to \*\_REQUEST_KWARGS_MAP with new syntax (hosts are allowed, tlds start with .)
  * Note: port arguments are stripped, localhost matches localhost:80, localhost:8000, ...
* >=0.18: change order of filter parameters, nearly all filters start with request (for compatibility with (django) decorators)
* >=0.21: huge change in python API, http API should be backward compatible
* >=0.22: switch to datacontent (except in rare special cases like in SpiderTag), 3party modules will break if they used BaseContent
# TODO
* implement UploadTextareaWidget
* maybe: status codes if forms fail should represent it
* fix RDF export and view of spider_tags
* examples
* documentation
* test admin
* cleanup travelprotection: either no trigger_passwords if no trigger action is selected, or depend for trigger on trigger_passwords
  * partly done, missing in frontend
* Localisation
  * harmonize punctation
* css theme instead inline style
## Later
* verify subproperties without resource:
  * delay hash calculation if Bnode, then create hash from hashable hash of bnode
  * this case currently doesn't happen as embed/raw is solely used and no bigger no-contents are currently in use
* delayed deletion of user (disable and strength 9 everywhere)
* maybe: make quota type overridable (maybe add extra nonsaved quota: other or use 0)
* create client side script for import (pushing to server, index token for auth?)
  * use browerside javascript?
* textfilet etherpad like synchronization
* pw protection: add migration tool for changed SECRET_KEY
* log changes
* improve protections, add protections
### Implement Web Comments
* every internal page can be annotated (to keep contact to author)
  * send as message?
  * CommentBox?
* Comment: url, subcommentlist, commenttext, reactionlist (reaction, counter)
* view: load iframe with original content?
* js for loading subcomments (only 1 level), sanitize!
* you see only the comments of your friends
* implement with messaging? Would keep comments private
* Later/Maybe:
  * way to register your comment url on webpage, so others can see all comments
  * social media stuff: find content via comments and likes
  * annotation of other pages
# Thanks
* Default theme uses Font Awesome by Dave Gandy - http://fontawesome.io
* Some text fields use Trumbowyg by Alexander Demode
* Django team for their excellent product

%package -n python3-spkcspider
Summary:	A secure, decentral platform for maintaining your online identity
Provides:	python-spkcspider
BuildRequires:	python3-devel
BuildRequires:	python3-setuptools
BuildRequires:	python3-pip
%description -n python3-spkcspider
spkcspider provides a digital visiting card which can e.g. be used for authentication, shopping and payment. For this a multifactor authentication is provided.
It keeps your online data safe while shopping by just providing a link to a potion of your data. Doing this, the user may can provide some knocking mechanism (e.g. has to provide some code, tan) to protect the content.
Further features and advantages of spkcspider are:
* cross device configuration without saving user data on webshop/service.
  This makes them easily DSGVO compatible without adjustments
* Address Data have to changed only on one place if you move. This is especially useful if you move a lot
  Also if you travel and want to buy something on the way.
* Verification of data is possible.
* Privacy: private servers are easily set up (only requirement: cgi), also compatible to tor
* Travelling: some people don't respect common rules for privacy. This tool allows you to keep your digital life private.
  * You don't have it on the device
  * You can hide your data with the travel mode (against the worst kind of inspectors)
    * Note: traces could be still existent (like "recently-used" feature, bookmarks)
  * for governments: use psychology instead of breaking into systems! The only victims are law-abidding citizens.
# Installation
This project can either be used as a standalone project (clone repo) or as a set of reusable apps (setup.py installation).
## Build Requirements
* npm
* pip >=19 (and poetry)
## Poetry (within virtual environment)
~~~~ sh
poetry install
# for installing with extras specify -E extra1 -E extra2
~~~~
## Pip
~~~~ sh
pip install .
~~~~
## Setup
~~~~ sh
npm install --no-save
./manager.py migrate
./manager.py collectstatic
# or simply use
./tools/install_deps.sh
~~~~
## Caveats
allow_domain_mode NULL errors:
some migration failed and now it is neccessary to redo them manually
connect to database and execute:
ALTER TABLE spider_base_usercomponent DROP COLUMN allow_domain_mode;
ALTER TABLE spider_base_assignedcontent DROP COLUMN allow_domain_mode;
this doesn't work in sqlite3 (
  export data (and remove allow_domain_mode if specified)
  recreate db file
  import data
  see: http://www.sqlitetutorial.net/sqlite-alter-table/ why you don't want to try it manually
)
Mysql works with some special settings:
Require mysql to use utf8 charset
To unbreak tests, use 'CHARSET': 'utf8':
~~~~ python
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'TEST': {
            'CHARSET': 'utf8'
        }
    }
}
~~~~
### Possibilities how to add utf8 charset to mysql:
* use 'read_default_file' and add "default-character-set = utf8" in config
* create database with "CHARACTER SET utf8"
* see: https://docs.djangoproject.com/en/dev/ref/databases/#mysql-notes
### \_\_old crashes object creation:
downgrade sqlite3 to 3.25 or upgrade django to at least 2.1.5/2.0.10
importing data:
set:
UPDATE_DYNAMIC_AFTER_MIGRATION = False
before importing data (with loaddata), update dynamic creates data
### keep pathes if switching from cgi
~~~~
location /cgi-bin/cgihandler.fcgi {
   rewrite /cgi-bin/cgihandler.fcgi/?(.*)$ https://new.spkcspider.net/$1 redirect ;
}
~~~~
### logging
In this model tokens are transferred as GET parameters. Consider disabling the
logging of GET parameters (at least the sensible ones) or better:
disable logging of succeeding requests
nginx filter tokens only (hard):
~~~~
location / {
  set $filtered_request $request;
  if ($filtered_request ~ (.*)token=[^&]*(.*)) {
      set $filtered_request $1token=****$2;
  }
}
log_format filtered_combined '$remote_addr - $remote_user [$time_local] '
                    '"$filtered_request" $status $body_bytes_sent '
                    '"$http_referer" "$http_user_agent"';
access_log /var/logs/nginx-access.log filtered_combined;
~~~~
nginx filter GET parameters:
~~~~
log_format filtered_combined '$remote_addr - $remote_user [$time_local] '
                    '"$uri" $status $body_bytes_sent '
                    '"$http_referer" "$http_user_agent"';
access_log /var/logs/nginx-access.log filtered_combined;
~~~~
apache filter GET parameters:
~~~~
LogFormat "%h %l %u %t \"%m %U %H\" %>s %b \"%{Referer}i\" \"%{User-agent}i\"" combined
~~~~
### localization
Don't use path based localization! This breaks the whole model.
Pathes should be unique for validation. Localisation in curl requests
can be archieved by headers.
# External usage
There are special GET parameters for controlling spkcspider:
* page=<int>: page number
* token=xy: token as GET parameter, if invalid: retrieve token as GET parameter
* token=prefer: uses invalid mechanic, easier to see what it does
* raw=true: optimize output for machines, use turtle format
* raw=embed: embed content of components, use turtle format
* id=id&id=id: limit content ids (Content lists only)
* search=foo&search=!notfoo: search case insensitive a string
* search=\_unlisted: List "unlisted" content if owner, special user (doesn't work in public list).
* protection=false: fail if protections are required
* protection=xy&protection=yx...: protections to use
* intention=auth: try to login with UserComponent authentication (falls back to login redirect)
* referrer=<url>: activate referrer mode
  * intention=domain: domain verify referrer mode
  * intention=sl: server-less referrer mode
  * payload=<foo>: passed on successful requests (including post), e.g. for sessionid
  * intention=login: referrer uses spkcspider for login (note: referrer should be the one where the user is logging in, check referrer field for that)
  * intention=persist: referrer can persist data on webserver
* embed_big=true: only for staff and superuser: Overrides maximal size of files which are embedded in graphs (only for default helper)
## special header
* Content-Type/Accept=application/json: some forms are rendered as json (currently only deletion form)
## Referrer
* normal referrer mode: send token to referrer, client verifies with hash that he sent the token.
* server-less referrer mode (sl): token is transferred as GET parameter and no POST request is made (less secure as client sees token and client is not authenticated)
* domain referrer mode (domain): referrer domain is add to token. Doesn't work with other intentions (but "live" mode is active as no filter will be created) and works only if domain_mode is for context active (e.g. feature or access context (content)). Can be automated, doesn't require user approval. Useful for tag updates (only active if feature requests domain mode).
### special intentions:
* sl: activates server less mode
* live: filter live instead using fixed ids
## search parameters
* search also searches UserComponents name and description fields
* can only be used with "list"-views
* items can be negated with !foo
* strict infofield search can be activated with \_
* !!foo escapes a !foo item
* \_\_foo escapes a \_foo item
* !\_ negates a strict infofield search
* \_unlisted is a special search: it lists with "unlisted" marked contents
verified_by urls should return last verification date for a hash
## raw mode
raw mode can follow references even in other components because it is readonly.
Otherwise security could be compromised.
## Important Features
* Persistence: Allow referrer to save data (used and activated by persistent features)
* WebConfig: Allow remote websites and servers to save config data on your server (requires Persistence)
* TmpConfig: Allow remote websites and servers to save config data on your server, attached to temporary tokens (means: they are gone after a while)
# internal API
## Structure
### spider:
For spiders and contents
* spkcspider.apps.spider: store User Components, common base, WARNING: has spider_base namespace to not break existing apps
* spkcspider.apps.spider_accounts: user implementation suitable for the spiders. You can supply your own user model instead.
* spkcspider.apps.spider_filets: File and Text Content types
* spkcspider.apps.spider_keys: Public keys and anchors
* spkcspider.apps.spider_tags: verified information tags
* spkcspider.apps.spider_webcfg: WebConfig Feature
* spkcspider: contains spkcspider url detection and wsgi handler
### verifier:
Base reference implementation of a verifier.
spkcspider.apps.verifier: verifier base utils WARNING: has spider_verifier namespace to not break existing apps
## info field syntax
The info field is a simple key value storage. The syntax is (strip the spaces):
flag syntax: \\x1e key \\x1e
key value syntax: \\x1e key=value \\x1e
Note: I use the semantic ascii seperators \\x1e. Why? Sperating with an non-printable character eases escaping and sanitizing.
Note 2: I reverted from using \\x1f instead of = because the info field is used in searchs
Why not a json field? Django has no uniform json field for every db adapter yet.
## forms
* forms.initial: will be used for rdf
* field.initial: only for initialization
## authentication/privileges
* request.is_staff: requesting user used staff rights to access view (not true in ComponentPublicIndex)
* request.is_owner: requesting user owns the components
* request.is_special_user: requesting user owns the components or is_staff
* request.protections: int: enough protections were fullfilled, maximal measured strength, list: protections which failed, False: no access; access with protections not possible
## Special Scopes
* add: create content, with AssignedContent form
* update: update content
* raw_update: update Content, without AssignedContent form, adds second raw update mode (raw_add is not existent, can be archieved by returning HttpResponse in add scope)
* export: export data (import not implemented yet)
* view: present content to untrusted parties
## strength (component)
* 0: no protection. Complete content visible
* 1-3: protection strength which can be provided by protections. Meta data (names, descriptions) visible, inclusion in sitemap, public components
* 4: login only, user password. Still with inclusion of metadata
* 5: public attribute not set. No inclusion in sitemap or public components index anymore
* 6-8: protections + public attribute not set
* 9: login only, user password + public attribute not set
* 10: index, login only, special protected. Protections are used for login. Content here can be made unique per user by using unique per component attribute
= extra["strength"] on token (if available elsewise treat as zero):
the strength of the usercomponent for which it was created at the creation point
## strength (protection)
* 0: no protection
* 1-3: weak, medium, strong
* 4: do component authentication
= extra["prot_strength"] on token (if available elsewise treat as zero):
the strength of protections which was passed for creating the token
Note: access tokens created by admin have strength 0
## get usercomponent/content from url/urlpart for features
Use UserComponent.objects.from_url_part(url) / AssignedContent.from_url_part(url, [matchers]) for that
or use a domain_mode or persistent token.
Note: the difference between a domain_mode and a persistent token is, that the domain_mode token has a variable lifetime (user specific but defaults to 7 days)
Note: AssignedContent.objects.from_url_part(url) returns tuple: (matched feature/content, content which contains content/feature or None)
# API Breaks
* >0.5: settings rename\*\_ TLD_PARAMS_MAPPING to \*\_REQUEST_KWARGS_MAP with new syntax (hosts are allowed, tlds start with .)
  * Note: port arguments are stripped, localhost matches localhost:80, localhost:8000, ...
* >=0.18: change order of filter parameters, nearly all filters start with request (for compatibility with (django) decorators)
* >=0.21: huge change in python API, http API should be backward compatible
* >=0.22: switch to datacontent (except in rare special cases like in SpiderTag), 3party modules will break if they used BaseContent
# TODO
* implement UploadTextareaWidget
* maybe: status codes if forms fail should represent it
* fix RDF export and view of spider_tags
* examples
* documentation
* test admin
* cleanup travelprotection: either no trigger_passwords if no trigger action is selected, or depend for trigger on trigger_passwords
  * partly done, missing in frontend
* Localisation
  * harmonize punctation
* css theme instead inline style
## Later
* verify subproperties without resource:
  * delay hash calculation if Bnode, then create hash from hashable hash of bnode
  * this case currently doesn't happen as embed/raw is solely used and no bigger no-contents are currently in use
* delayed deletion of user (disable and strength 9 everywhere)
* maybe: make quota type overridable (maybe add extra nonsaved quota: other or use 0)
* create client side script for import (pushing to server, index token for auth?)
  * use browerside javascript?
* textfilet etherpad like synchronization
* pw protection: add migration tool for changed SECRET_KEY
* log changes
* improve protections, add protections
### Implement Web Comments
* every internal page can be annotated (to keep contact to author)
  * send as message?
  * CommentBox?
* Comment: url, subcommentlist, commenttext, reactionlist (reaction, counter)
* view: load iframe with original content?
* js for loading subcomments (only 1 level), sanitize!
* you see only the comments of your friends
* implement with messaging? Would keep comments private
* Later/Maybe:
  * way to register your comment url on webpage, so others can see all comments
  * social media stuff: find content via comments and likes
  * annotation of other pages
# Thanks
* Default theme uses Font Awesome by Dave Gandy - http://fontawesome.io
* Some text fields use Trumbowyg by Alexander Demode
* Django team for their excellent product

%package help
Summary:	Development documents and examples for spkcspider
Provides:	python3-spkcspider-doc
%description help
spkcspider provides a digital visiting card which can e.g. be used for authentication, shopping and payment. For this a multifactor authentication is provided.
It keeps your online data safe while shopping by just providing a link to a potion of your data. Doing this, the user may can provide some knocking mechanism (e.g. has to provide some code, tan) to protect the content.
Further features and advantages of spkcspider are:
* cross device configuration without saving user data on webshop/service.
  This makes them easily DSGVO compatible without adjustments
* Address Data have to changed only on one place if you move. This is especially useful if you move a lot
  Also if you travel and want to buy something on the way.
* Verification of data is possible.
* Privacy: private servers are easily set up (only requirement: cgi), also compatible to tor
* Travelling: some people don't respect common rules for privacy. This tool allows you to keep your digital life private.
  * You don't have it on the device
  * You can hide your data with the travel mode (against the worst kind of inspectors)
    * Note: traces could be still existent (like "recently-used" feature, bookmarks)
  * for governments: use psychology instead of breaking into systems! The only victims are law-abidding citizens.
# Installation
This project can either be used as a standalone project (clone repo) or as a set of reusable apps (setup.py installation).
## Build Requirements
* npm
* pip >=19 (and poetry)
## Poetry (within virtual environment)
~~~~ sh
poetry install
# for installing with extras specify -E extra1 -E extra2
~~~~
## Pip
~~~~ sh
pip install .
~~~~
## Setup
~~~~ sh
npm install --no-save
./manager.py migrate
./manager.py collectstatic
# or simply use
./tools/install_deps.sh
~~~~
## Caveats
allow_domain_mode NULL errors:
some migration failed and now it is neccessary to redo them manually
connect to database and execute:
ALTER TABLE spider_base_usercomponent DROP COLUMN allow_domain_mode;
ALTER TABLE spider_base_assignedcontent DROP COLUMN allow_domain_mode;
this doesn't work in sqlite3 (
  export data (and remove allow_domain_mode if specified)
  recreate db file
  import data
  see: http://www.sqlitetutorial.net/sqlite-alter-table/ why you don't want to try it manually
)
Mysql works with some special settings:
Require mysql to use utf8 charset
To unbreak tests, use 'CHARSET': 'utf8':
~~~~ python
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'TEST': {
            'CHARSET': 'utf8'
        }
    }
}
~~~~
### Possibilities how to add utf8 charset to mysql:
* use 'read_default_file' and add "default-character-set = utf8" in config
* create database with "CHARACTER SET utf8"
* see: https://docs.djangoproject.com/en/dev/ref/databases/#mysql-notes
### \_\_old crashes object creation:
downgrade sqlite3 to 3.25 or upgrade django to at least 2.1.5/2.0.10
importing data:
set:
UPDATE_DYNAMIC_AFTER_MIGRATION = False
before importing data (with loaddata), update dynamic creates data
### keep pathes if switching from cgi
~~~~
location /cgi-bin/cgihandler.fcgi {
   rewrite /cgi-bin/cgihandler.fcgi/?(.*)$ https://new.spkcspider.net/$1 redirect ;
}
~~~~
### logging
In this model tokens are transferred as GET parameters. Consider disabling the
logging of GET parameters (at least the sensible ones) or better:
disable logging of succeeding requests
nginx filter tokens only (hard):
~~~~
location / {
  set $filtered_request $request;
  if ($filtered_request ~ (.*)token=[^&]*(.*)) {
      set $filtered_request $1token=****$2;
  }
}
log_format filtered_combined '$remote_addr - $remote_user [$time_local] '
                    '"$filtered_request" $status $body_bytes_sent '
                    '"$http_referer" "$http_user_agent"';
access_log /var/logs/nginx-access.log filtered_combined;
~~~~
nginx filter GET parameters:
~~~~
log_format filtered_combined '$remote_addr - $remote_user [$time_local] '
                    '"$uri" $status $body_bytes_sent '
                    '"$http_referer" "$http_user_agent"';
access_log /var/logs/nginx-access.log filtered_combined;
~~~~
apache filter GET parameters:
~~~~
LogFormat "%h %l %u %t \"%m %U %H\" %>s %b \"%{Referer}i\" \"%{User-agent}i\"" combined
~~~~
### localization
Don't use path based localization! This breaks the whole model.
Pathes should be unique for validation. Localisation in curl requests
can be archieved by headers.
# External usage
There are special GET parameters for controlling spkcspider:
* page=<int>: page number
* token=xy: token as GET parameter, if invalid: retrieve token as GET parameter
* token=prefer: uses invalid mechanic, easier to see what it does
* raw=true: optimize output for machines, use turtle format
* raw=embed: embed content of components, use turtle format
* id=id&id=id: limit content ids (Content lists only)
* search=foo&search=!notfoo: search case insensitive a string
* search=\_unlisted: List "unlisted" content if owner, special user (doesn't work in public list).
* protection=false: fail if protections are required
* protection=xy&protection=yx...: protections to use
* intention=auth: try to login with UserComponent authentication (falls back to login redirect)
* referrer=<url>: activate referrer mode
  * intention=domain: domain verify referrer mode
  * intention=sl: server-less referrer mode
  * payload=<foo>: passed on successful requests (including post), e.g. for sessionid
  * intention=login: referrer uses spkcspider for login (note: referrer should be the one where the user is logging in, check referrer field for that)
  * intention=persist: referrer can persist data on webserver
* embed_big=true: only for staff and superuser: Overrides maximal size of files which are embedded in graphs (only for default helper)
## special header
* Content-Type/Accept=application/json: some forms are rendered as json (currently only deletion form)
## Referrer
* normal referrer mode: send token to referrer, client verifies with hash that he sent the token.
* server-less referrer mode (sl): token is transferred as GET parameter and no POST request is made (less secure as client sees token and client is not authenticated)
* domain referrer mode (domain): referrer domain is add to token. Doesn't work with other intentions (but "live" mode is active as no filter will be created) and works only if domain_mode is for context active (e.g. feature or access context (content)). Can be automated, doesn't require user approval. Useful for tag updates (only active if feature requests domain mode).
### special intentions:
* sl: activates server less mode
* live: filter live instead using fixed ids
## search parameters
* search also searches UserComponents name and description fields
* can only be used with "list"-views
* items can be negated with !foo
* strict infofield search can be activated with \_
* !!foo escapes a !foo item
* \_\_foo escapes a \_foo item
* !\_ negates a strict infofield search
* \_unlisted is a special search: it lists with "unlisted" marked contents
verified_by urls should return last verification date for a hash
## raw mode
raw mode can follow references even in other components because it is readonly.
Otherwise security could be compromised.
## Important Features
* Persistence: Allow referrer to save data (used and activated by persistent features)
* WebConfig: Allow remote websites and servers to save config data on your server (requires Persistence)
* TmpConfig: Allow remote websites and servers to save config data on your server, attached to temporary tokens (means: they are gone after a while)
# internal API
## Structure
### spider:
For spiders and contents
* spkcspider.apps.spider: store User Components, common base, WARNING: has spider_base namespace to not break existing apps
* spkcspider.apps.spider_accounts: user implementation suitable for the spiders. You can supply your own user model instead.
* spkcspider.apps.spider_filets: File and Text Content types
* spkcspider.apps.spider_keys: Public keys and anchors
* spkcspider.apps.spider_tags: verified information tags
* spkcspider.apps.spider_webcfg: WebConfig Feature
* spkcspider: contains spkcspider url detection and wsgi handler
### verifier:
Base reference implementation of a verifier.
spkcspider.apps.verifier: verifier base utils WARNING: has spider_verifier namespace to not break existing apps
## info field syntax
The info field is a simple key value storage. The syntax is (strip the spaces):
flag syntax: \\x1e key \\x1e
key value syntax: \\x1e key=value \\x1e
Note: I use the semantic ascii seperators \\x1e. Why? Sperating with an non-printable character eases escaping and sanitizing.
Note 2: I reverted from using \\x1f instead of = because the info field is used in searchs
Why not a json field? Django has no uniform json field for every db adapter yet.
## forms
* forms.initial: will be used for rdf
* field.initial: only for initialization
## authentication/privileges
* request.is_staff: requesting user used staff rights to access view (not true in ComponentPublicIndex)
* request.is_owner: requesting user owns the components
* request.is_special_user: requesting user owns the components or is_staff
* request.protections: int: enough protections were fullfilled, maximal measured strength, list: protections which failed, False: no access; access with protections not possible
## Special Scopes
* add: create content, with AssignedContent form
* update: update content
* raw_update: update Content, without AssignedContent form, adds second raw update mode (raw_add is not existent, can be archieved by returning HttpResponse in add scope)
* export: export data (import not implemented yet)
* view: present content to untrusted parties
## strength (component)
* 0: no protection. Complete content visible
* 1-3: protection strength which can be provided by protections. Meta data (names, descriptions) visible, inclusion in sitemap, public components
* 4: login only, user password. Still with inclusion of metadata
* 5: public attribute not set. No inclusion in sitemap or public components index anymore
* 6-8: protections + public attribute not set
* 9: login only, user password + public attribute not set
* 10: index, login only, special protected. Protections are used for login. Content here can be made unique per user by using unique per component attribute
= extra["strength"] on token (if available elsewise treat as zero):
the strength of the usercomponent for which it was created at the creation point
## strength (protection)
* 0: no protection
* 1-3: weak, medium, strong
* 4: do component authentication
= extra["prot_strength"] on token (if available elsewise treat as zero):
the strength of protections which was passed for creating the token
Note: access tokens created by admin have strength 0
## get usercomponent/content from url/urlpart for features
Use UserComponent.objects.from_url_part(url) / AssignedContent.from_url_part(url, [matchers]) for that
or use a domain_mode or persistent token.
Note: the difference between a domain_mode and a persistent token is, that the domain_mode token has a variable lifetime (user specific but defaults to 7 days)
Note: AssignedContent.objects.from_url_part(url) returns tuple: (matched feature/content, content which contains content/feature or None)
# API Breaks
* >0.5: settings rename\*\_ TLD_PARAMS_MAPPING to \*\_REQUEST_KWARGS_MAP with new syntax (hosts are allowed, tlds start with .)
  * Note: port arguments are stripped, localhost matches localhost:80, localhost:8000, ...
* >=0.18: change order of filter parameters, nearly all filters start with request (for compatibility with (django) decorators)
* >=0.21: huge change in python API, http API should be backward compatible
* >=0.22: switch to datacontent (except in rare special cases like in SpiderTag), 3party modules will break if they used BaseContent
# TODO
* implement UploadTextareaWidget
* maybe: status codes if forms fail should represent it
* fix RDF export and view of spider_tags
* examples
* documentation
* test admin
* cleanup travelprotection: either no trigger_passwords if no trigger action is selected, or depend for trigger on trigger_passwords
  * partly done, missing in frontend
* Localisation
  * harmonize punctation
* css theme instead inline style
## Later
* verify subproperties without resource:
  * delay hash calculation if Bnode, then create hash from hashable hash of bnode
  * this case currently doesn't happen as embed/raw is solely used and no bigger no-contents are currently in use
* delayed deletion of user (disable and strength 9 everywhere)
* maybe: make quota type overridable (maybe add extra nonsaved quota: other or use 0)
* create client side script for import (pushing to server, index token for auth?)
  * use browerside javascript?
* textfilet etherpad like synchronization
* pw protection: add migration tool for changed SECRET_KEY
* log changes
* improve protections, add protections
### Implement Web Comments
* every internal page can be annotated (to keep contact to author)
  * send as message?
  * CommentBox?
* Comment: url, subcommentlist, commenttext, reactionlist (reaction, counter)
* view: load iframe with original content?
* js for loading subcomments (only 1 level), sanitize!
* you see only the comments of your friends
* implement with messaging? Would keep comments private
* Later/Maybe:
  * way to register your comment url on webpage, so others can see all comments
  * social media stuff: find content via comments and likes
  * annotation of other pages
# Thanks
* Default theme uses Font Awesome by Dave Gandy - http://fontawesome.io
* Some text fields use Trumbowyg by Alexander Demode
* Django team for their excellent product

%prep
%autosetup -n spkcspider-0.30

%build
%py3_build

%install
%py3_install
install -d -m755 %{buildroot}/%{_pkgdocdir}
if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
pushd %{buildroot}
if [ -d usr/lib ]; then
	find usr/lib -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
if [ -d usr/lib64 ]; then
	find usr/lib64 -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
if [ -d usr/bin ]; then
	find usr/bin -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
if [ -d usr/sbin ]; then
	find usr/sbin -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
touch doclist.lst
if [ -d usr/share/man ]; then
	find usr/share/man -type f -printf "\"/%h/%f.gz\"\n" >> doclist.lst
fi
popd
mv %{buildroot}/filelist.lst .
mv %{buildroot}/doclist.lst .

%files -n python3-spkcspider -f filelist.lst
%dir %{python3_sitelib}/*

%files help -f doclist.lst
%{_docdir}/*

%changelog
* Fri Jun 09 2023 Python_Bot <Python_Bot@openeuler.org> - 0.30-1
- Package Spec generated