auth.h 1.73 KB
Newer Older
1 2 3 4 5 6 7
/*
 * Copyright (C) the libgit2 contributors. All rights reserved.
 *
 * This file is part of libgit2, distributed under the GNU GPL v2 with
 * a Linking Exception. For full terms see the included COPYING file.
 */

8 9
#ifndef INCLUDE_transports_auth_h__
#define INCLUDE_transports_auth_h__
10

11 12
#include "common.h"

13 14 15 16
#include "git2.h"
#include "netops.h"

typedef enum {
17 18 19 20
	GIT_HTTP_AUTH_BASIC = 1,
	GIT_HTTP_AUTH_NEGOTIATE = 2,
	GIT_HTTP_AUTH_NTLM = 4,
} git_http_auth_t;
21 22 23 24 25

typedef struct git_http_auth_context git_http_auth_context;

struct git_http_auth_context {
	/** Type of scheme */
26
	git_http_auth_t type;
27 28

	/** Supported credentials */
29
	git_credential_t credtypes;
30 31 32

	/** Connection affinity or request affinity */
	unsigned connection_affinity : 1;
33 34 35 36 37

	/** Sets the challenge on the authentication context */
	int (*set_challenge)(git_http_auth_context *ctx, const char *challenge);

	/** Gets the next authentication token from the context */
38
	int (*next_token)(git_buf *out, git_http_auth_context *ctx, git_credential *cred);
39

40 41 42
	/** Examines if all tokens have been presented. */
	int (*is_complete)(git_http_auth_context *ctx);

43 44 45 46 47 48
	/** Frees the authentication context */
	void (*free)(git_http_auth_context *ctx);
};

typedef struct {
	/** Type of scheme */
49
	git_http_auth_t type;
50 51 52 53 54

	/** Name of the scheme (as used in the Authorization header) */
	const char *name;

	/** Credential types this scheme supports */
55
	git_credential_t credtypes;
56 57 58 59

	/** Function to initialize an authentication context */
	int (*init_context)(
		git_http_auth_context **out,
60
		const git_net_url *url);
61 62 63 64
} git_http_auth_scheme;

int git_http_auth_dummy(
	git_http_auth_context **out,
65
	const git_net_url *url);
66 67 68

int git_http_auth_basic(
	git_http_auth_context **out,
69
	const git_net_url *url);
70 71

#endif