Qpid Proton C API 0.39.0
 
Loading...
Searching...
No Matches
sasl.h
Go to the documentation of this file.
1#ifndef PROTON_SASL_H
2#define PROTON_SASL_H 1
3
4/*
5 *
6 * Licensed to the Apache Software Foundation (ASF) under one
7 * or more contributor license agreements. See the NOTICE file
8 * distributed with this work for additional information
9 * regarding copyright ownership. The ASF licenses this file
10 * to you under the Apache License, Version 2.0 (the
11 * "License"); you may not use this file except in compliance
12 * with the License. You may obtain a copy of the License at
13 *
14 * http://www.apache.org/licenses/LICENSE-2.0
15 *
16 * Unless required by applicable law or agreed to in writing,
17 * software distributed under the License is distributed on an
18 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
19 * KIND, either express or implied. See the License for the
20 * specific language governing permissions and limitations
21 * under the License.
22 *
23 */
24
25#include <proton/import_export.h>
26#include <proton/type_compat.h>
27#include <proton/types.h>
28
29#ifdef __cplusplus
30extern "C" {
31#endif
32
49typedef struct pn_sasl_t pn_sasl_t;
50
54typedef enum {
55 PN_SASL_NONE = -1,
60 PN_SASL_TEMP = 4
62
77PN_EXTERN pn_sasl_t *pn_sasl(pn_transport_t *transport);
78
91PN_EXTERN bool pn_sasl_extended(void);
92
101PN_EXTERN void pn_sasl_done(pn_sasl_t *sasl, pn_sasl_outcome_t outcome);
102
107
125PN_EXTERN const char *pn_sasl_get_user(pn_sasl_t *sasl);
126
145PN_EXTERN const char *pn_sasl_get_authorization(pn_sasl_t *sasl);
146
156PN_EXTERN const char *pn_sasl_get_mech(pn_sasl_t *sasl);
157
175PN_EXTERN void pn_sasl_allowed_mechs(pn_sasl_t *sasl, const char *mechs);
176
194PN_EXTERN void pn_sasl_set_allow_insecure_mechs(pn_sasl_t *sasl, bool insecure);
195
202
215PN_EXTERN void pn_sasl_config_name(pn_sasl_t *sasl, const char *name);
216
232PN_EXTERN void pn_sasl_config_path(pn_sasl_t *sasl, const char *path);
233
238#ifdef __cplusplus
239}
240#endif
241
242#endif /* sasl.h */
void pn_sasl_done(pn_sasl_t *sasl, pn_sasl_outcome_t outcome)
Deprecated - Do not use.
pn_sasl_outcome_t pn_sasl_outcome(pn_sasl_t *sasl)
Retrieve the outcome of SASL negotiation.
pn_sasl_t * pn_sasl(pn_transport_t *transport)
Construct an Authentication and Security Layer object.
const char * pn_sasl_get_mech(pn_sasl_t *sasl)
Return the selected SASL mechanism.
bool pn_sasl_extended(void)
Do we support extended SASL negotiation.
const char * pn_sasl_get_authorization(pn_sasl_t *sasl)
Retrieve the authorization id.
struct pn_sasl_t pn_sasl_t
The SASL layer is responsible for establishing an authenticated and/or encrypted tunnel over which AM...
Definition: sasl.h:49
void pn_sasl_allowed_mechs(pn_sasl_t *sasl, const char *mechs)
SASL mechanisms that are to be considered for authentication.
const char * pn_sasl_get_user(pn_sasl_t *sasl)
Retrieve the authenticated user.
void pn_sasl_config_path(pn_sasl_t *sasl, const char *path)
Set the sasl configuration path.
bool pn_sasl_get_allow_insecure_mechs(pn_sasl_t *sasl)
Return the current value for allow_insecure_mechs.
void pn_sasl_config_name(pn_sasl_t *sasl, const char *name)
Set the sasl configuration name.
pn_sasl_outcome_t
The result of the SASL negotiation.
Definition: sasl.h:54
void pn_sasl_set_allow_insecure_mechs(pn_sasl_t *sasl, bool insecure)
Boolean to allow use of clear text authentication mechanisms.
@ PN_SASL_OK
negotiation not completed
Definition: sasl.h:56
@ PN_SASL_PERM
failed due to a system error
Definition: sasl.h:59
@ PN_SASL_AUTH
authentication succeeded
Definition: sasl.h:57
@ PN_SASL_SYS
failed due to bad credentials
Definition: sasl.h:58
@ PN_SASL_TEMP
failed due to unrecoverable error
Definition: sasl.h:60
struct pn_transport_t pn_transport_t
A network channel supporting an AMQP connection.
Definition: types.h:435
AMQP and API data types.