NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

1. Inform our developers how to develop on our secure services
2. Inform our clients how to connect to our secure services

Developing Secure Services (PO / PA)

These instructions are written for developers of po-grid secure COPPA services on non-Windows (Linux / OSX) platforms.

Purpose

To inform our developers how to develop on secure grid services.

Prerequistes

  1. Install caGrid v1.3 locally, http://cagrid.org/display/downloads/caGrid+1.3+Installation+Quick+Start
  2. Obtain a grid credential (or Dorian User Account) for the grid trust fabric needed, e.g. Training Grid. (developers working locally should use the Training Grid) See http://cagrid.org/display/cagrid13tutorials/Create+User+Account for instructions.
  3. Request a Host Cert to be used locally, http://cagrid.org/display/knowledgebase/Request+a+Host+CertificateImage Added. You should specify your local machine's hostname. For example, locally I use
    Code Block
    
    steve-matyass-macbook-pro-2.local
    
  4. Record your grid credential (aka Grid Identity) for later use. For example, mine is
    Code Block
    
    /O=caBIG/OU=caGrid/OU=Training/OU=Dorian/CN=matyass
    

Steps to Code & Test Locally

  1. Each day before you start using coding and testing locally, you'll want to Login to Dorian using the GAARDS UI to extend your local grid identity certificates. Roughly ever 24 hours they expire.
  2. Ensure your build-po/install.properties and build-po/upgrade.properties files contain the correct values, namely the following:
    Code Block
    
    pogrid.grid.secure.cert.location=${user.home}/.cagrid/certificates/${pogrid.grid.external.secure.host}-cert.pem
    pogrid.grid.secure.key.location=${user.home}/.cagrid/certificates/${pogrid.grid.external.secure.host}-key.pem
    pogrid.grid.external.secure.host=${env.HOSTNAME}
    
    By default, we're going to folder contains default Update your local

Purpose

To inform our clients (consumers) how to connect to and consume our secure services.

Prerequistes

  1. Install caGrid v1.3 locally, http://cagrid.org/display/downloads/caGrid+1.3+Installation+Quick+Start
  2. Obtain a grid credential (or Dorian User Account) for the grid trust fabric needed, e.g. Training Grid. (developers working locally should use the Training Grid) See http://cagrid.org/display/cagrid13tutorials/Create+User+Account for instructions.
  3. Request a Host Cert to be used locally, http://cagrid.org/display/knowledgebase/Request+a+Host+CertificateImage Added. You should specify your local machine's hostname. For example, locally I use
    Code Block
    
    steve-matyass-macbook-pro-2.local
    
  4. Record your grid credential (aka Grid Identity) for later use. For example, mine is
    Code Block
    
    /O=caBIG/OU=caGrid/OU=Training/OU=Dorian/CN=matyass
    

User Guide

Quick Start Guide

These instructions are written for pa-grid but apply to po-grid as well (change pa to po, etc, as needed).

...