thodg/libgit2/src/transports/auth.h

• Show log

  Commit

• Hash : 10e8fe55
  Author :
  Date : 2019-03-21T13:55:54
  

  transports: add an `is_complete` function for auth Some authentication mechanisms (like HTTP Basic and Digest) have a one-step mechanism to create credentials, but there are more complex mechanisms like NTLM and Negotiate that require challenge/response after negotiation, requiring several round-trips. Add an `is_complete` function to know when they have round-tripped enough to be a single authentication and should now either have succeeded or failed to authenticate.

Download

• src/transports/auth.h

• /*
   * 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.
   */
  
  #ifndef INCLUDE_transports_auth_h__
  #define INCLUDE_transports_auth_h__
  
  #include "common.h"
  
  #include "git2.h"
  #include "netops.h"
  
  typedef enum {
  	GIT_AUTHTYPE_BASIC = 1,
  	GIT_AUTHTYPE_NEGOTIATE = 2,
  	GIT_AUTHTYPE_NTLM = 4,
  } git_http_authtype_t;
  
  typedef struct git_http_auth_context git_http_auth_context;
  
  struct git_http_auth_context {
  	/** Type of scheme */
  	git_http_authtype_t type;
  
  	/** Supported credentials */
  	git_credtype_t credtypes;
  
  	/** Connection affinity or request affinity */
  	unsigned connection_affinity : 1;
  
  	/** 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 */
  	int (*next_token)(git_buf *out, git_http_auth_context *ctx, git_cred *cred);
  
  	/** Examines if all tokens have been presented. */
  	int (*is_complete)(git_http_auth_context *ctx);
  
  	/** Frees the authentication context */
  	void (*free)(git_http_auth_context *ctx);
  };
  
  typedef struct {
  	/** Type of scheme */
  	git_http_authtype_t type;
  
  	/** Name of the scheme (as used in the Authorization header) */
  	const char *name;
  
  	/** Credential types this scheme supports */
  	git_credtype_t credtypes;
  
  	/** Function to initialize an authentication context */
  	int (*init_context)(
  		git_http_auth_context **out,
  		const git_net_url *url);
  } git_http_auth_scheme;
  
  int git_http_auth_dummy(
  	git_http_auth_context **out,
  	const git_net_url *url);
  
  int git_http_auth_basic(
  	git_http_auth_context **out,
  	const git_net_url *url);
  
  #endif
  

Download