Cache Primer for Sharepoint with ADFSv3
Project description
Overview
The first time a browser hits a sharepoint site after a restart, the caches are empty, so the page can take a while to load. One can script something to silently hit a sharepoint web-frontend, causing it to build caches and preventing any real people from experiencing that.
This tool does this for a specific circumstance where it’s kind of hard to script it without better tools - where normal NTML authentication doesn’t work, because there is ADFSv3 authentication configured, and where there may be a number of web-frontends behind a load balancer.
I don’t know why this is required. I’m not a sharepoint admin. Maybe it’s an artifact of a particular setup.
Installation
- Simple install:
pip install sharepointcacheprimer
Usage
usage: sharepointcacheprimer [-h] config site [site …]
Connect to sharepoint site, authenticate, and load a page, thereby priming the caches. The configuration file should contain a section defining each site you are priming.
- positional arguments:
config configuration ini file site sites (section names) in configuration ini file to prime
- optional arguments:
- -h, --help
show this help message and exit
Configuration
>From the included doc/example.ini:
# Each section is either a site definition or a cookieset definition
#### A Site Definition # This is a set sharepoint site, with ADFS credentials and an optional # reference to a cookieset to use. [example.com] ; Site: example.com username = domainuser1 ; ADFS username password = password1 ; ADFS password url = http://example.com ; URL that for site to prime cookielist = examplecookies ; Optional sectionname for Cookie Sets
#### A Cookieset Definition # Every line is a cookie # NAME = value1,value2,valuen # For each value of each cookie, the site will be primed once. This # allows a site pool that uses a cookie-based load balancer to force # iterating through every web frontend via cookies. # In the below example, the cookie “LB-COOKIE” will be set for each of # three attempts, using the values abc1, abc2, and abc3 respectively. # # If more than one list of cookies is below, that will just be an # additional iteration. For example, another line with 2 more values # would cause a total of 5 priming attempts with 5 unique cookie values. [examplecookies] ; The label referenced above LB-COOKIE = abc1,abc2,abc3 ; A cookie list, comma-delimited
#### The same settings as above, without comments: [example.com] username = domainuser1 password = password1 url = http://example.com cookielist = examplecookies
[examplecookies] LB-COOKIE = abc1,abc2,abc3
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for sharepointcacheprimer-1.0b3.post1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5bfd4d51d88c57ade0a001aef6a175db69df2117731234795609facaa51f999d |
|
MD5 | 9d51aec76a6364dc9973745f89e82e2a |
|
BLAKE2b-256 | 1e1deb2aa97dc0212945b2ec3c30e0735fc1c9f98ad77ad249bfddd5b17d76de |
Hashes for sharepointcacheprimer-1.0b3.post1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 807fa1557278a23e8b84acf91293cb301e1e93e3f489e6a10fb91246ce08b2c9 |
|
MD5 | db87f4f24639c8369ddb94a1cd6b4216 |
|
BLAKE2b-256 | b663cfbb536a74c1940bc89280d2413439bcd98859a3efd2a4ccf3d7239aefe5 |