annotate auth.html @ 1640:1ae8b89d3a86

Creating site for 2.5-SNAPSHOT
author Robert Casties <casties@mpiwg-berlin.mpg.de>
date Tue, 22 Aug 2017 16:38:19 +0000
parents
children 16be3440305b
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1640
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
1 <!DOCTYPE html>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
2 <!--
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
3 | Generated by Apache Maven Doxia at 2017-08-22
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
4 | Rendered using Apache Maven Fluido Skin 1.3.0
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
5 -->
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
6 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
7 <head>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
8 <meta charset="UTF-8" />
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
9 <meta name="viewport" content="width=device-width, initial-scale=1.0" />
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
10 <meta name="Date-Revision-yyyymmdd" content="20170822" />
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
11 <meta http-equiv="Content-Language" content="en" />
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
12 <title>digilib - The Digital Image Library &#x2013; Access control</title>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
13 <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
14 <link rel="stylesheet" href="./css/site.css" />
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
15 <link rel="stylesheet" href="./css/print.css" media="print" />
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
16
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
17
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
18 <script type="text/javascript" src="./js/apache-maven-fluido-1.3.0.min.js"></script>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
19
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
20
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
21 </head>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
22 <body class="topBarDisabled">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
23
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
24
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
25
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
26 <div class="container-fluid">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
27 <div id="banner">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
28 <div class="pull-left">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
29 <a href="./" id="bannerLeft">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
30 <h2>digilib - a versatile image viewing environment for the internet</h2>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
31 </a>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
32 </div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
33 <div class="pull-right"> <a href="./" id="bannerRight">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
34 <img src="images/digilib-logo-small.png" />
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
35 </a>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
36 </div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
37 <div class="clear"><hr/></div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
38 </div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
39
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
40 <div id="breadcrumbs">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
41 <ul class="breadcrumb">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
42
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
43
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
44 <li id="publishDate">Last Published: 2017-08-22</li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
45 <li class="divider">|</li> <li id="projectVersion">Version: 2.5-SNAPSHOT</li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
46
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
47
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
48
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
49
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
50 </ul>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
51 </div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
52
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
53
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
54 <div class="row-fluid">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
55 <div id="leftColumn" class="span3">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
56 <div class="well sidebar-nav">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
57
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
58
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
59 <ul class="nav nav-list">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
60 <li class="nav-header">Overview</li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
61
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
62 <li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
63
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
64 <a href="index.html" title="About digilib">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
65 <i class="none"></i>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
66 About digilib</a>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
67 </li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
68
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
69 <li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
70
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
71 <a href="features.html" title="digilib features">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
72 <i class="none"></i>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
73 digilib features</a>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
74 </li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
75
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
76 <li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
77
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
78 <a href="digilib-short.html" title="How digilib works">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
79 <i class="none"></i>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
80 How digilib works</a>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
81 </li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
82
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
83 <li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
84
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
85 <a href="history.html" title="Ancient history">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
86 <i class="none"></i>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
87 Ancient history</a>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
88 </li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
89 <li class="nav-header">Installation</li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
90
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
91 <li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
92
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
93 <a href="install-digilib.html" title="Installing digilib">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
94 <i class="none"></i>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
95 Installing digilib</a>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
96 </li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
97
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
98 <li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
99
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
100 <a href="build-maven.html" title="Building digilib">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
101 <i class="none"></i>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
102 Building digilib</a>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
103 </li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
104 <li class="nav-header">Configuration</li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
105
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
106 <li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
107
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
108 <a href="digilib-config.html" title="Configuring digilib">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
109 <i class="none"></i>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
110 Configuring digilib</a>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
111 </li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
112
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
113 <li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
114
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
115 <a href="image-directories.html" title="Directory layout">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
116 <i class="none"></i>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
117 Directory layout</a>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
118 </li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
119
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
120 <li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
121
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
122 <a href="java-settings.html" title="Java settings and tuning">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
123 <i class="none"></i>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
124 Java settings and tuning</a>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
125 </li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
126
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
127 <li class="active">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
128
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
129 <a href="#"><i class="none"></i>Access control</a>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
130 </li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
131 <li class="nav-header">Development</li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
132
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
133 <li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
134
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
135 <a href="scaler-api.html" title="The digilib Scaler API">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
136 <i class="none"></i>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
137 The digilib Scaler API</a>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
138 </li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
139
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
140 <li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
141
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
142 <a href="iiif-api.html" title="The digilib IIIF API">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
143 <i class="none"></i>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
144 The digilib IIIF API</a>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
145 </li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
146
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
147 <li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
148
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
149 <a href="client-integration.html" title="Integrating digilib into your page">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
150 <i class="none"></i>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
151 Integrating digilib into your page</a>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
152 </li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
153
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
154 <li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
155
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
156 <a href="plugins.html" title="Digilib plugins">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
157 <i class="none"></i>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
158 Digilib plugins</a>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
159 </li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
160 <li class="nav-header">Project Documentation</li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
161
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
162 <li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
163
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
164 <a href="project-info.html" title="Project Information">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
165 <i class="icon-chevron-right"></i>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
166 Project Information</a>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
167 </li>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
168 </ul>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
169
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
170
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
171
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
172 <hr class="divider" />
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
173
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
174 <div id="poweredBy">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
175 <div class="clear"></div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
176 <div class="clear"></div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
177 <div class="clear"></div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
178 <a href="http://maven.apache.org/" title="Built by Maven" class="builtBy">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
179 <img class="builtBy" alt="Built by Maven" src="http://maven.apache.org/images/logos/maven-feather.png" />
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
180 </a>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
181 <a href="http://www.sourceforge.net/" title="Hosted by SourceForge" class="builtBy">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
182 <img class="builtBy" alt="Hosted by SourceForge" src="http://upload.wikimedia.org/wikipedia/commons/0/0b/Sourceforge_logo.png" />
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
183 </a>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
184 </div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
185 </div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
186 </div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
187
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
188
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
189 <div id="bodyColumn" class="span9" >
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
190
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
191 <h1>Access control</h1>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
192 <p>If all your images are free and available to everybody or if your server is not reachable from the internet then congratulations, you can run digilib without authorization: Leave the <a href="digilib-config.html">digilib-config</a> setting </p>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
193
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
194 <div class="source">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
195 <div class="source">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
196 <pre>use-authorization=false
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
197 </pre></div></div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
198 <p>and ignore the rest of this chapter.</p>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
199 <p>But if you have some images that are freely available and others that should be only visible to some users then you need to set</p>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
200
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
201 <div class="source">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
202 <div class="source">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
203 <pre>use-authorization=true
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
204 </pre></div></div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
205 <p>and configure digilib&#x2019;s authentication and authorization mechanism.</p>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
206 <div class="section">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
207 <h2><a name="Authentication_and_authorization"></a>Authentication and authorization</h2>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
208 <p>digilib has different mechanisms for the tasks of <i>authentication</i> - establishing the identity of the user requesting the image (more accurately the roles associated to this identity) - and <i>authorization</i> - establishing the rules for accessing specific images (the roles required to access the image).</p>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
209 <p>The authe<b>n</b>tication mechanism is implemented by the digilib.auth.Auth<b>n</b>Ops interface implemented through the class configured in the <tt>digilib-config</tt> parameter <tt>authnops-class</tt> while the authori<b>z</b>ation mechanism is implemented by the digilib.auth.Auth<b>z</b>Ops interface implemented through the class configured in <tt>authzops-class</tt>.</p>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
210 <p>All authentication and authorization classes are configured through different elements in the XML config file</p>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
211
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
212 <div class="source">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
213 <div class="source">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
214 <pre>digilib-auth.xml
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
215 </pre></div></div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
216 <p>in the <tt>WEB-INF</tt> directory (the file name can be configured with the <tt>digilib-config</tt> parameter <tt>auth-file</tt>).</p>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
217 <p>In short: you need to set both <tt>authnops-class</tt> and <tt>authzops-class</tt> in <tt>digilib-config</tt> with two of the classes described below (or implement your own) and create a <tt>digilib-auth.xml</tt> file with the configuration for the chosen implementations.</p>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
218 <div class="section">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
219 <h3><a name="Authentication:_IpAuthnOps"></a>Authentication: IpAuthnOps</h3>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
220 <p><tt>digilib.auth.IpAuthnOps</tt> assigns roles based on the IP address of the user requesting the image. This works well for situations where all users of the local network are allowed to access resources. The class reads the tag <tt>digilib-adresses</tt> from <tt>digilib-auth.xml</tt>:</p>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
221
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
222 <div class="source">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
223 <div class="source">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
224 <pre>&lt;digilib-addresses&gt;
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
225 &lt;address ip=&quot;130.92.68&quot; role=&quot;eastwood-coll,ptolemaios-geo&quot; /&gt;
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
226 &lt;address ip=&quot;130.92.151&quot; role=&quot;wtwg&quot; /&gt;
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
227 &lt;address ip=&quot;0:0:0:0:0:0:0:1&quot; role=&quot;local&quot; /&gt;
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
228 &lt;/digilib-addresses&gt;
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
229 </pre></div></div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
230 <p>A computer with an ip address that matches <tt>ip</tt> is automatically granted all roles under <tt>role</tt>. The ip address is matched from the left (in full quads). Roles under &#x201c;role&#x201d; must be separated by comma only (no spaces). </p>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
231 <p>Caution: If you run your Servlet Container (Tomcat) behind Apache or another reverse proxy then Tomcat only sees the IP address of the proxy server for all connections. You need to configure Tomcat to honor the <tt>X-Forwarded-For</tt> and <tt>X-Forwarded-Proto</tt> headers.</p></div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
232 <div class="section">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
233 <h3><a name="Authentication:_IpServletAuthnOps"></a>Authentication: IpServletAuthnOps</h3>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
234 <p><tt>digilib.auth.IpServletAuthnOps</tt> assigns roles based on the IP address of the user requesting the image (see <tt>IpAuthnOps</tt> above) and uses the <tt>ServletRequest.isUserInRole()</tt> function of the Servlet Container if the roles provided by the IP address are not sufficient.</p>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
235 <p>Using authentication information from the Servlet Container requires that the Servlet Container is configured for authentication. For information about this please refer to the documentation of your Servlet Container.</p>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
236 <p>For Tomcat 8 there is documentation at (<a class="externalLink" href="https://tomcat.apache.org/tomcat-8.0-doc/realm-howto.html)[https://tomcat.apache.org/tomcat-8.0-doc/realm-howto.html">https://tomcat.apache.org/tomcat-8.0-doc/realm-howto.html)[https://tomcat.apache.org/tomcat-8.0-doc/realm-howto.html</a>] Note that you need to configure a <tt>&lt;security-constraint&gt;</tt> in <tt>web.xml</tt> to force the server to ask for a password (there is an old example in <tt>web-additional.xml</tt>).</p></div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
237 <div class="section">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
238 <h3><a name="Authentication:_OpenIdAuthnOps"></a>Authentication: OpenIdAuthnOps</h3>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
239 <p><tt>digilib.auth.OpenIdAuthnOps</tt> assigns roles based on an <a class="externalLink" href="http://openid.net/">OpenId-Connect</a> token passed with the request. The token can be passed either in the URL parameter <tt>id_token</tt> or as a cookie with the name <tt>id_token</tt> (the name of the cookie can be configured with the <tt>digilib-config</tt> parameter <tt>authn-token-cookie</tt>).</p>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
240 <p>The class reads the tag <tt>digilib-oauth</tt> from <tt>digilib-auth.xml</tt>:</p>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
241
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
242 <div class="source">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
243 <div class="source">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
244 <pre>&lt;digilib-oauth&gt;
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
245 &lt;openid issuer=&quot;https://id.some.where&quot; clientid=&quot;myclient&quot; roles=&quot;openid-users&quot; keytype=&quot;jwk&quot;&gt;
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
246 {&quot;kty&quot;:&quot;RSA&quot;,&quot;e&quot;:&quot;AQAB&quot;,&quot;kid&quot;:&quot;rsa1&quot;,&quot;alg&quot;:&quot;RS256&quot;,&quot;n&quot;:&quot;qt6yOiI_wCoCVlGO0MySsez...Lf9by7TGw&quot;}
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
247 &lt;/openid&gt;
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
248 &lt;/digilib-oauth&gt;
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
249 </pre></div></div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
250 <p>The <tt>openid</tt> tag defines roles (in <tt>role</tt>, separated by comma only, no spaces) that will be granted to the user that provides a valid token from the given server. The server is identified by the url in <tt>issuer</tt>, the client id in <tt>clientid</tt> and the public key of the server in JWK format as content of the tag. There can be multiple <tt>openid</tt> tags.</p>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
251 <p>To set up a connection with an OpenId-Connect identity server you usually have to enter the URL of your digilib instance as a redirect URL and the client id that you chose and make sure that the server answers requests with <tt>response_type=id_token</tt>. The public key of the server in JWK format can often be requested from the server by adding <tt>/jwk</tt> to the URL.</p>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
252 <p>To automatically authenticate with OpenId in the digilib Javascript frontend you can use the digilib plugin <tt>jquery.digilib.oauth.js</tt> and configure it with the URL of the ID server as <tt>authServerUrl</tt> and the client id as <tt>authClientId</tt>. This will give you an extra login button that authenticates the user by redirecting her to the ID server. You can additionally set <tt>authOnErrorMode</tt> to true to automatically authenticate the user whenever the image from the digilib server doesn&#x2019;t load which is usually caused by missing authentication (there is an example in <tt>jquery/digilib-auth.html</tt>).</p></div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
253 <div class="section">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
254 <h3><a name="Authentication:_IpOpenIdAuthnOps"></a>Authentication: IpOpenIdAuthnOps</h3>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
255 <p><tt>digilib.auth.IpOpenIdAuthnOps</tt> assigns roles based on the IP address of the user requesting the image (see <tt>IpAuthnOps</tt> above) and uses an OpenId-Connect token passed with the request (see <tt>OpenIdAuthnOps</tt> above) if the roles provided by the IP address are not sufficient.</p></div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
256 <div class="section">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
257 <h3><a name="Authorization:_PathAuthzOps"></a>Authorization: PathAuthzOps</h3>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
258 <p><tt>digilib.auth.PathAuthzOps</tt> requests roles based on the directory path of the requested image. All images in the given directory and all its subdirectories can be accessed only if the user can provide one of the requested roles.</p>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
259 <p>The class reads the tag <tt>digilib-paths</tt> from <tt>digilib-auth.xml</tt>:</p>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
260
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
261 <div class="source">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
262 <div class="source">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
263 <pre>&lt;digilib-paths&gt;
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
264 &lt;path name=&quot;histast/eastwood-collection&quot; role=&quot;eastwood-coll&quot;/&gt;
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
265 &lt;path name=&quot;documents/nonpublic&quot; role=&quot;openid-user,eastwood-coll&quot;/&gt;
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
266 &lt;/digilib-paths&gt;
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
267 </pre></div></div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
268 <p>A user must supply one of the roles in <tt>role</tt> to access the directory in <tt>name</tt>. Roles in <tt>role</tt> must be separated by comma only (no spaces).</p></div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
269 <div class="section">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
270 <h3><a name="Authorization:_MetaAccessAuthzOps"></a>Authorization: MetaAccessAuthzOps</h3>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
271 <p><tt>digilib.auth.MetaAccessAuthzOps</tt> requests roles using &#x201c;access&#x201d; information in the file metadata.</p>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
272 <p>This requires a <tt>FileMeta</tt> implementation (configured in the <tt>filemeta-class</tt> parameter of <tt>digilib-config</tt>) that provides an <tt>access</tt> key in the metadata returned by <tt>DocuDirent.getMeta().getFileMeta()</tt> like <tt>digilib.meta.IndexMetaFileMeta</tt>.</p>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
273 <p>The class reads the tag <tt>digilib-access</tt> from <tt>digilib-auth.xml</tt>: </p>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
274
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
275 <div class="source">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
276 <div class="source">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
277 <pre>&lt;digilib-access&gt;
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
278 &lt;access type=&quot;group:mpiwg&quot; role=&quot;mpiwg-user&quot;/&gt;
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
279 &lt;access type=&quot;default&quot; role=&quot;&quot;/&gt;
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
280 &lt;/digilib-access&gt;
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
281 </pre></div></div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
282 <p>A user must supply one of the roles in <tt>role</tt> to access any object with a metadata access value matching <tt>type</tt>. Roles in <tt>role</tt> must be separated by comma only (no spaces).</p>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
283 <p>The access type <tt>default</tt> is special, it applies to all objects without metadata access information.</p>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
284 <p><tt>digilib.meta.IndexMetaFileMeta</tt> reads XML files conforming to the <a class="externalLink" href="http://intern.mpiwg-berlin.mpg.de/digitalhumanities/mpiwg-metadata-documentation/formate/indexmeta-standard">&#x201c;index.meta&#x201d; specification</a> and extracts image information from the <tt>meta/img</tt> tag and access information from the <tt>meta/access-conditions</tt> tag (see also class <tt>digilib.meta.IndexMetaAuthLoader</tt>).</p></div></div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
285 </div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
286 </div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
287 </div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
288
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
289 <hr/>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
290
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
291 <footer>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
292 <div class="container-fluid">
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
293 <div class="row span12">Copyright &copy; 2001-2017
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
294 <a href="http://digilib.sourceforge.net">digilib Community</a>.
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
295 All Rights Reserved.
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
296
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
297 </div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
298
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
299
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
300
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
301 </div>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
302 </footer>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
303 </body>
1ae8b89d3a86 Creating site for 2.5-SNAPSHOT
Robert Casties <casties@mpiwg-berlin.mpg.de>
parents:
diff changeset
304 </html>