argus/pep.h

Go to the documentation of this file.

/*
 * Copyright (c) Members of the EGEE Collaboration. 2006-2010.
 * See http://www.eu-egee.org/partners/ for details on the copyright holders.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

/*
 * Argus PEP client API
 *
 * $Id$
 * @author Valery Tschopp <valery.tschopp@switch.ch>
 * @version 2.1
 */
#ifndef _PEP_H_
#define _PEP_H_

#ifdef  __cplusplus
extern "C" {
#endif

#include <stdarg.h> /* va_list */
#include "xacml.h"
#include "profiles.h"
#include "pip.h"
#include "oh.h"
#include "error.h"



#define PEP_LOGLEVEL_NONE  -1 
#define PEP_LOGLEVEL_ERROR  0 
#define PEP_LOGLEVEL_WARN   1 
#define PEP_LOGLEVEL_INFO   2 
#define PEP_LOGLEVEL_DEBUG  3 
typedef int pep_log_handler_callback(int level, const char * format, va_list args);

typedef struct pep_handle PEP;

typedef enum pep_option {
    PEP_OPTION_LOG_LEVEL,  
    PEP_OPTION_LOG_STDERR,  
    PEP_OPTION_LOG_HANDLER,  
    PEP_OPTION_ENDPOINT_URL, 
    PEP_OPTION_ENDPOINT_SSL_VALIDATION, 
    PEP_OPTION_ENDPOINT_SERVER_CERT, 
    PEP_OPTION_ENDPOINT_SERVER_CAPATH, 
    PEP_OPTION_ENDPOINT_CLIENT_CERT, 
    PEP_OPTION_ENDPOINT_CLIENT_KEY, 
    PEP_OPTION_ENDPOINT_CLIENT_KEYPASSWORD, 
    PEP_OPTION_ENDPOINT_TIMEOUT, 
    PEP_OPTION_ENABLE_PIPS, 
    PEP_OPTION_ENABLE_OBLIGATIONHANDLERS, 
    PEP_OPTION_ENDPOINT_SSL_CIPHER_LIST 
} pep_option_t;

const char * pep_version(void);

pep_error_t pep_global_init(void);

void pep_global_cleanup(void);

PEP * pep_initialize(void);

int pep_getid(PEP * pep);

pep_error_t pep_addpip(PEP * pep, const pep_pip_t * pip);

pep_error_t pep_addobligationhandler(PEP * pep, const pep_obligationhandler_t * oh);

pep_error_t pep_setoption(PEP * pep, pep_option_t option, ... );

pep_error_t pep_authorize(PEP * pep, xacml_request_t ** request, xacml_response_t ** response);

void pep_destroy(PEP * pep);

#ifdef  __cplusplus
}
#endif

#endif

---