From 093991c8c4dc8256454f8be45ce2693e0cf2015f Mon Sep 17 00:00:00 2001 From: Francesco Giacomini <giaco at cnaf dot infn dot it> Date: Sat, 24 Feb 2018 18:06:34 +0100 Subject: [PATCH] README --- README.md | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..ec7990d --- /dev/null +++ b/README.md @@ -0,0 +1,31 @@ +# ngx_http_voms_module + +## Description + +_ngx_http_voms_module_ is a module for the [NGINX web server](https://www.nginx.org/) that enables client-side authentication based on X.509 proxies augmented with Attribute Certificates, typically obtained through a [Virtual Organization Membership Service](https://italiangrid.github.io/voms/) (VOMS). + +## Installation + +The generic installation instructions are: + + $ cd nginx-1.x.y + $ ./configure --add-module=/path/to/ngx_http_voms_module + $ make && make install + +A Docker image is available for use in the context of the StoRM2 project, where the OpenResty distribution is used: + + $ docker run --rm -it -v /path/to/ngx_http_voms_module:/home/build/ngx_http_voms_module storm2/ngx-voms-build + % cd openresty-1.x.y + % ./configure ${resty_config_options} --add-module=../ngx_http_voms_module + % make && make install + +## Variables + +The module makes the following variables available for use in an NGINX configuration file: + +### voms_fqans + +A comma-separated list of _Fully Qualified Attribute Names_ + +### voms_user + -- GitLab