From 600063fbaaaf588db44d426045c15ebe28a53812 Mon Sep 17 00:00:00 2001 From: Mike Taylor Date: Tue, 28 Oct 2014 15:51:50 +0000 Subject: [PATCH] Restructure authentication sections. --- doc/mkws-manual.markdown | 34 +++++++++++++++------------------- 1 file changed, 15 insertions(+), 19 deletions(-) diff --git a/doc/mkws-manual.markdown b/doc/mkws-manual.markdown index bfc856f..85d1d51 100644 --- a/doc/mkws-manual.markdown +++ b/doc/mkws-manual.markdown @@ -431,8 +431,20 @@ The relevant properties (`popup_width`, etc.) are documented in the reference section. -Authentication and target configuration ---------------------------------------- +MKWS target selection +===================== + +Introduction +------------ + +MKWS accesses targets using the Pazpar2 metasearching engine. Although +Pazpar2 can be used directly, using a statically configured set of +targets, this usage is unusual. More often, Pazpar2 is fronted by the +Service Proxy (SP), which manages authentication, sessions, target +selection, etc. This document assumes the SP is used, and explains how +to go about making a set of targets (a "library") available, how to +connect your MKWS application to that library, and how to choose which +of the available targets to use. MKWS configures itself to use an account on a service hosted by `sp-mkws.indexdata.com`. By default, it sends no authentication @@ -449,23 +461,7 @@ In order to search in a customised set of targets, including subscription resources, it's necessary to create an account with Index Data's hosted Service Proxy, and protect that account with authentication tokens (to prevent unauthorised use of subscription -resources). For information on how to do this, see the next section. - - -MKWS target selection -===================== - -MKWS accesses targets using the Pazpar2 metasearching engine. Although -Pazpar2 can be used directly, using a statically configured set of -targets, this usage is unusual. More often, Pazpar2 is fronted by the -Service Proxy (SP), which manages authentication, sessions, target -selection, etc. - -This document assumes the SP is used, and explains how to go about -making a set of targets (a "library") available, how to connect your -MKWS application to that library, and how to choose which of the -available targets to use. - +resources). Maintaining the library ----------------------- -- 1.7.10.4