உள்ளடக்கத்திற்கு செல்க

சேவையக உள்ளமைவு

உங்கள் தேவைகளைப் நிறைவு செய்ய திறந்த வலை காலெண்டரை மாற்ற விரும்பினால், இது நல்லது. நீங்கள் தேர்வு செய்யலாம்

  • இயல்புநிலை காலண்டர் எப்படி இருக்கும் என்பதை மாற்றவும்.
  • சேவையகம் எவ்வாறு செயல்படுகிறது என்பதை மாற்றவும்.

இயல்புநிலை காலெண்டரை கட்டமைத்தல்

அனைத்து காலெண்டர்களின் உள்ளமைவும் [இயல்புநிலை விவரக்குறிப்பு] இல் வேரூன்றியுள்ளது. அந்த மதிப்புகள் அனைத்தையும் வலையில் வழங்கப்பட்ட இந்த கோப்பின் நகல் மூலம் காலண்டர் அளவுரு விவரக்குறிப்பு_ஆர்ல் மூலம் மாற்றலாம். ஒவ்வொரு அளவுருவும் [இயல்புநிலை விவரக்குறிப்பு] இல் ஆவணப்படுத்தப்பட வேண்டும்.

உங்கள் நிகழ்வில் புரவலன் செய்யப்பட்ட ** அனைத்து காலெண்டர்களும் ** மாற்ற, OWC_SPECIFICATION சுற்றுச்சூழல் மாறியைப் பயன்படுத்தவும். காலெண்டர்கள் அவற்றின் உள்ளமைவுக்காக சில மதிப்புகளை மேலெழுதும். அவை மேலெழுதாதவை இயல்புநிலை விவரக்குறிப்பால் பாதிக்கப்படுகின்றன. மாற்றப்பட வேண்டிய உள்ளமைவு பக்கத்திற்கு எல்லா மதிப்புகளும் வெளிப்படுவதில்லை. அந்த மதிப்புகள் இன்னும் விவரக்குறிப்பு_ஆர்ல் மற்றும் வினவல் அளவுருக்களில் மாற்றப்படலாம்.

பின்வரும் மதிப்புகளை மாற்ற நீங்கள் விரும்பலாம்.

title

உங்கள் வலைத்தளத்தின் தலைப்பு.

language

இது இயல்புநிலை மொழி. உள்ளமைவு பக்கத்தை உள்ளக பார்வையாளர்களுக்கு சிறப்பாக வழங்க இதை மாற்ற நீங்கள் விரும்பலாம்.

favicon

இது வலைத்தள ஐகானுக்கான இணைப்பு.

source_code

நீங்கள் மாற்றங்களைச் செய்தால், பார்வையாளர்களுக்கு அவர்களை வெளியிடுவதற்கு நீங்கள் சட்டப்பூர்வமாக தேவை. தயவுசெய்து இணைப்பை சரிசெய்யவும் அல்லது அவற்றை முதன்மையான திட்டத்திற்கு மீண்டும் பங்களிக்கவும்.

contributing

உங்கள் திட்டத்திற்கு பங்களிக்க நீங்கள் திருப்பி விட விரும்பினால்.

privacy_policy

இந்த சேவையை நீங்களே புரவலன் செய்தால், இயல்புநிலை தனியுரிமைக் கொள்கை ஐப் பயன்படுத்தலாம்.

சில காரணங்களால் நீங்கள் தரவைச் சேகரிக்க முடிவு செய்தால், அதாவது HTTPS பதிலாள் அல்லது பதிவு ஐபி முகவரிகளில், நீங்கள் உங்கள் சொந்த தனியுரிமைக் கொள்கையை உருவாக்க வேண்டும். இந்த திட்டத்தில் ஒன்றை நீங்கள் இணைக்கலாம்.

மேலும் மதிப்புகள்

மாற்றக்கூடிய பல மதிப்புகள் உள்ளன. தயவுசெய்து [இயல்புநிலை_ விவரக்குறிப்பு] ஐப் பார்க்கவும். இந்த மதிப்புகள் அனைத்தும் ஆவணப்படுத்தப்பட்டுள்ளன. அவற்றை மாற்ற OWC_SPECIFICATION சுற்றுச்சூழல் மாறியைப் பயன்படுத்தவும்.

மேலும் காண்க:

சேவையகத்தை உள்ளமைத்தல்

சுற்றுச்சூழல் மாறிகள் சேவையகத்தின் இயக்கத்தை மட்டுமே பாதிக்கின்றன. சேவையை உள்ளமைக்க இந்த சுற்றுச்சூழல் மாறிகள் பயன்படுத்தப்படலாம்:

ALLOWED_HOSTS

இயல்புநிலை காலியாக உள்ளது

திறந்த வலை காலெண்டரை அணுக அனுமதிக்கப்பட்ட கமாவால் வாடிக்கையாளர்கள் வகுக்கப்படுகிறார்கள். நீங்கள் சேவையை அணுக முயற்சித்தால் இந்த உரையைப் பார்ப்பீர்கள், உங்களுக்கு இசைவு இல்லை:

Forbidden: You don’t have the permission to access the requested resource. It is either read-protected or not readable by the server.*

எடுத்துக்காட்டுகள்:

  • ஒரே கணினியை மட்டுமே அனுமதிக்கவும்: அனுமதிக்கப்பட்ட_ஓச்ட்ச் = உள்ளக ஓச்ட்
  • பல ஓச்ட்களை அனுமதிக்கவும்: அனுமதிக்கப்பட்ட_ஓச்ட்ச் = 192.168.0.1,192.168.2, api.myserver.com
  • சேவையகத்தை அணுக அனைவரையும் அனுமதிக்கவும் (இயல்புநிலை): அனுமதிக்கப்பட்ட_ஓச்ட்ச் = அல்லது அனுமதிக்கப்பட்ட_ஓச்ட்ச் =*

This functionality is provided by flask-allowed-hosts.

APP_DEBUG

default false, values true or false, always false in the Docker container

பயன்பாட்டிற்கான பிழைத்திருத்த கொடியை அமைக்கவும்.

CACHE_DIRECTORY

default is a temporary directory (e.g. in /tmp/)

The Open Web Calendar caches files needed to display calendars in this directory to speed up loading. If the directory does not exist, it will be created.

CACHE_FILE_SIZE

default 20 (MB)

This is the maximum size of one file in the cache. When the cache is full, the least recently used file is removed.

எடுத்துக்காட்டுகள்:

  • Allow only small files of 4KB: CACHE_FILE_SIZE=0.004
  • Allow any size: CACHE_FILE_SIZE="$CACHE_SIZE"
  • Disable caching: CACHE_FILE_SIZE=0

CACHE_SIZE

default 200 (MB)

This is the maximum cache size in megabytes. This size is limited to 200MB in order to mitigate the cache filling the file system or in case of /tmp/ the RAM.

எடுத்துக்காட்டுகள்:

  • Use 1 GB for caching: CACHE_SIZE=1024
  • Unlimited cache: CACHE_SIZE=unlimited
  • Disable caching: CACHE_SIZE=0

CACHE_REQUESTED_URLS_FOR_SECONDS

default 600 (seconds)

அலைவரிசை மற்றும் தாமதத்தைக் குறைப்பதற்காக பதிவிறக்கம் செய்யப்படும் காலண்டர் கோப்புகளை கேச் செய்ய விநாடிகள்.

எடுத்துக்காட்டுகள்:

  • வேகமாக புதுப்பிக்கவும்: cache_requested_urls_for_seconds = 10
  • Disable caching: CACHE_REQUESTED_URLS_FOR_SECONDS=0

OWC_ENCRYPTION_KEYS

இயல்புநிலை காலியாக உள்ளது

This is a comma separated list of encryption keys. These can be used to hide sensitive information of URLs.

எடுத்துக்காட்டுகள்:

  • Disable encryption (default): OWC_ENCRYPTION_KEYS=
  • Use one key: OWC_ENCRYPTION_KEYS='Pj...48='
  • Use multiple keys: OWC_ENCRYPTION_KEYS='Pj...48=,cx...Fw=' If you use multiple keys, only the first one encrypts the data. The others are only used to decrypt the data.

You can generate a new key by visiting your instance of the Open Web Calendar on the page /new-key or by running this command:

python3 -m open_web_calendar.new_key

மேலும் காண்க:

ஒடபுள்யுசி_விவரக்குறிப்பு

OWC_SPECIFICATION என்பது ஒரு விருப்ப சூழல் மாறி.

  • இது செல்லுபடியாகும் YAML அல்லது சாதொபொகு கொண்ட கோப்புக்கு ** பாதை ** ஆக இருக்கலாம்.
  • இது செல்லுபடியாகும் YAML அல்லது சாதொபொகு ஐக் கொண்ட ** சரம் ** ஆக இருக்கலாம்.

OWC_SPECIFICATION அமைப்பது அனைத்து காலெண்டர்களுக்கும் இயல்புநிலை மதிப்புகளை மாற்ற உங்களை அனுமதிக்கிறது.

குறிப்பு

திறந்த வலை காலெண்டரின் புதிய பதிப்புகள் புதிய உள்ளமைவு அளவுருக்களைச் சேர்க்கலாம். Default_specification கோப்பை மாற்றுவதற்குப் பதிலாக இந்த மாறியில் உங்கள் மாற்றங்களை வைப்பது எதிர்கால பதிப்பில் திறந்த வலை காலெண்டரை உடைக்கவில்லை என்பதை உறுதி செய்யும்.

பின்வரும் எடுத்துக்காட்டில், தங்கள் சொந்த தலைப்பை அமைக்காத அனைத்து காலெண்டர்களுக்கும் தலைப்பு மாற்றப்படும்.

OWC_SPECIFICATION='{"title": "calendar"}' gunicorn open_web_calendar:app

மேலும் காண்க:

PORT

இயல்புநிலை 5000, இயல்புநிலை80 கப்பல்துறை கொள்கலனில்

பணி இயங்கும் துறைமுகம்.

எடுத்துக்காட்டுகள்:

  • HTTP போர்ட்டில் பரிமாறவும்: போர்ட் = 80

WORKERS

இயல்புநிலை 4, கப்பல்துறை கொள்கலனுக்கு மட்டுமே

கோரிக்கைகளை கையாள இணையான தொழிலாளர்களின் எண்ணிக்கை.

எடுத்துக்காட்டுகள்:

  • ஒரு தொழிலாளியைப் பயன்படுத்துங்கள்: தொழிலாளர்கள் = 1

மேலும் உள்ளமைவு

திறந்த வலை காலண்டர் நூலகங்களைப் பயன்படுத்துகிறது, அதன் நடத்தை மேலும் தனிப்பயனாக்க முடியும்.

The Open Web Calendar relies on proxy servers for these features:

  • Access Control and Users To restrict who can use the Open Web Calendar, you can use nginx or apache as a reverse proxy in front of it. YuNoHost is another self-hosting option to restrict access.
  • HTTPS Encryption This can be done by nginx, apache or caddy.
  • More Advanced Caching Basic caching is handeled by the Open Web Calendar. For more advanced cache configuration, use a proxy server like squid. Have a look in the documentation below on how to make the Open Web Calendar access the web only through a proxy.
  • Restricting Access to Calendars By default, the Open Web Calendar does not restrict which calendars to show. Use the proxy server to filter the calendars. If you run the Open Web Calendar behind a firewall with other web services, setting up a proxy is necessary to protect from SSRF attacks.

பதிலாள் சேவையகத்துடன் எச்.எச்.ஆர்.எஃப் பாதுகாப்பு

The Open Web Calendar can be used to access the local network behind a firewall, see Issue 250. This free access is intended to show calendars from everywhere. Since requests is used by the Open Web Calendar, it can use a proxy as described in the requests documentation. The proxy can then handle the filtering.

export HTTP_PROXY="http://10.10.1.10:3128"
export HTTPS_PROXY="http://10.10.1.10:1080"
export ALL_PROXY="socks5://10.10.1.10:3434"

மேலும் காண்க:

Squid as a Proxy Server

The Squid Proxy and Cache is flexible and configurable. You can use it in front of the Open Web Calendar to configure access and customize caching.

Operating System

Squid is avaiable for all major platforms. For the commands and paths of this tutorial, we assume you run Squid on Debain/Ubuntu. The commands might work on other systems, but that is not tested.

After you have installed the Squid Proxy, add this file into the conf.d directory. Squid will load it automatically then.

In Linux, create /etc/squid/conf.d/open-web-calendar.conf:

## Example rule to deny access to your local networks.
## Adapt to list your (internal) IP networks from where browsing
## should be allowed
acl owc_forbidden dst 0.0.0.1-0.255.255.255  # RFC 1122 "this" network (LAN)
acl owc_forbidden dst 10.0.0.0/8             # RFC 1918 local private network (LAN)
acl owc_forbidden dst 100.64.0.0/10          # RFC 6598 shared address space (CGN)
acl owc_forbidden dst 169.254.0.0/16         # RFC 3927 link-local (directly plugged) machines
acl owc_forbidden dst 172.16.0.0/12          # RFC 1918 local private network (LAN)
acl owc_forbidden dst 192.168.0.0/16         # RFC 1918 local private network (LAN)
acl owc_forbidden dst fc00::/7               # RFC 4193 local private network range
acl owc_forbidden dst fe80::/10              # RFC 4291 link-local (directly plugged) machines

## If the Open Web Calendar runs on another machine, not localhost (127.0.0.1),
## fill in the network or IP of that machine here and allow access from it.
acl owc_host src 127.0.0.1           # Allow Access to Squid from localhost (default)
# acl owc_host src 172.16.0.0/12     # Uncomment if you run the Open Web Calendar as a docker service

## Access from owc_host is allowed to all but forbidden networks
http_access allow owc_host !owc_forbidden

## Use IPv4 for DNS
## See https://superuser.com/a/1443889
dns_v4_first on

The list above denies the Open Web Calendar access to all known local/internal networks. If you have your own local network (IPv4 or IPv6), add it to the list above to be sure.

On Linux, you can install the file with this command:

sudo wget -O /etc/squid/conf.d/open-web-calendar.conf https://raw.githubusercontent.com/niccokunzmann/open-web-calendar/master/docs/snippets/squid/open-web-calendar.conf

Then, restart the squid proxy.

sudo service squid reload

Set the environment variables to tell the Open Web Calendar to use the Squid proxy installed on localhost. Setting this variable changes depending on how you run the Open Web Calendar.

If you use the Python Setup, you can set the environment variables for the server like this:

export HTTP_PROXY="http://localhost:3128"
export HTTPS_PROXY="http://localhost:3128"
export ALL_PROXY="http://localhost:3128"
gunicorn open_web_calendar:app

http://172.16.0.1/calendar.ics போன்ற தடைசெய்யப்பட்ட நாட்காட்டியை உள்ளகopen-web-calendar உடன் அணுக முயற்சிக்கும்போது, இந்தப் பிழைச் செய்தியைக் காண்பீர்கள்:

403 Client Error: Forbidden for url: http://172.16.0.1/calendar.ics