include/openssl/http.h

   1 /*
   2  * Copyright 2000-2021 The OpenSSL Project Authors. All Rights Reserved.
   3  * Copyright Siemens AG 2018-2020
   4  *
   5  * Licensed under the Apache License 2.0 (the "License").  You may not use
   6  * this file except in compliance with the License.  You can obtain a copy
   7  * in the file LICENSE in the source distribution or at
   8  * https://www.openssl.org/source/license.html
   9  */
  10
  11 #ifndef OPENSSL_HTTP_H
  12 # define OPENSSL_HTTP_H
  13 # pragma once
  14
  15 # include <openssl/opensslconf.h>
  16
  17 # include <openssl/bio.h>
  18 # include <openssl/asn1.h>
  19 # include <openssl/conf.h>
  20
  21
  22 # ifdef __cplusplus
  23 extern "C" {
  24 # endif
  25
  26 typedef BIO *(*OSSL_HTTP_bio_cb_t)(BIO *bio, void *arg, int connect, int detail);
  27
  28 # define OSSL_HTTP_NAME "http"
  29 # define OSSL_HTTPS_NAME "https"
  30 # define OSSL_HTTP_PREFIX OSSL_HTTP_NAME"://"
  31 # define OSSL_HTTPS_PREFIX OSSL_HTTPS_NAME"://"
  32 # define OSSL_HTTP_PORT "80"
  33 # define OSSL_HTTPS_PORT "443"
  34 # define OPENSSL_NO_PROXY "NO_PROXY"
  35 # define OPENSSL_HTTP_PROXY "HTTP_PROXY"
  36 # define OPENSSL_HTTPS_PROXY "HTTPS_PROXY"
  37
  38 OSSL_HTTP_REQ_CTX *OSSL_HTTP_REQ_CTX_new(BIO *wbio, BIO *rbio,
  39                                          int method_GET, int maxline,
  40                                          unsigned long max_resp_len,
  41                                          int timeout,
  42                                          const char *expected_content_type,
  43                                          int expect_asn1);
  44 void OSSL_HTTP_REQ_CTX_free(OSSL_HTTP_REQ_CTX *rctx);
  45 int OSSL_HTTP_REQ_CTX_set_request_line(OSSL_HTTP_REQ_CTX *rctx,
  46                                        const char *server, const char *port,
  47                                        const char *path);
  48 int OSSL_HTTP_REQ_CTX_add1_header(OSSL_HTTP_REQ_CTX *rctx,
  49                                   const char *name, const char *value);
  50 int OSSL_HTTP_REQ_CTX_i2d(OSSL_HTTP_REQ_CTX *rctx, const char *content_type,
  51                           const ASN1_ITEM *it, ASN1_VALUE *req);
  52 int OSSL_HTTP_REQ_CTX_nbio(OSSL_HTTP_REQ_CTX *rctx);
  53 ASN1_VALUE *OSSL_HTTP_REQ_CTX_sendreq_d2i(OSSL_HTTP_REQ_CTX *rctx,
  54                                           const ASN1_ITEM *it);
  55 BIO *OSSL_HTTP_REQ_CTX_get0_mem_bio(OSSL_HTTP_REQ_CTX *rctx);
  56 void OSSL_HTTP_REQ_CTX_set_max_response_length(OSSL_HTTP_REQ_CTX *rctx,
  57                                                unsigned long len);
  58
  59 BIO *OSSL_HTTP_get(const char *url, const char *proxy, const char *no_proxy,
  60                    BIO *bio, BIO *rbio,
  61                    OSSL_HTTP_bio_cb_t bio_update_fn, void *arg,
  62                    const STACK_OF(CONF_VALUE) *headers,
  63                    int maxline, unsigned long max_resp_len, int timeout,
  64                    const char *expected_content_type, int expect_asn1);
  65 ASN1_VALUE *OSSL_HTTP_get_asn1(const char *url,
  66                                const char *proxy, const char *no_proxy,
  67                                BIO *bio, BIO *rbio,
  68                                OSSL_HTTP_bio_cb_t bio_update_fn, void *arg,
  69                                const STACK_OF(CONF_VALUE) *headers,
  70                                int maxline, unsigned long max_resp_len,
  71                                int timeout, const char *expected_content_type,
  72                                const ASN1_ITEM *it);
  73 ASN1_VALUE *OSSL_HTTP_post_asn1(const char *server, const char *port,
  74                                 const char *path, int use_ssl,
  75                                 const char *proxy, const char *no_proxy,
  76                                 BIO *bio, BIO *rbio,
  77                                 OSSL_HTTP_bio_cb_t bio_update_fn, void *arg,
  78                                 const STACK_OF(CONF_VALUE) *headers,
  79                                 const char *content_type,
  80                                 const ASN1_VALUE *req, const ASN1_ITEM *req_it,
  81                                 int maxline, unsigned long max_resp_len,
  82                                 int timeout, const char *expected_ct,
  83                                 const ASN1_ITEM *rsp_it);
  84 BIO *OSSL_HTTP_transfer(const char *server, const char *port, const char *path,
  85                         int use_ssl, const char *proxy, const char *no_proxy,
  86                         BIO *bio, BIO *rbio,
  87                         OSSL_HTTP_bio_cb_t bio_update_fn, void *arg,
  88                         const STACK_OF(CONF_VALUE) *headers,
  89                         const char *content_type, BIO *req_mem,
  90                         int maxline, unsigned long max_resp_len, int timeout,
  91                         const char *expected_ct, int expect_asn1,
  92                         char **redirection_url);
  93 int OSSL_HTTP_proxy_connect(BIO *bio, const char *server, const char *port,
  94                             const char *proxyuser, const char *proxypass,
  95                             int timeout, BIO *bio_err, const char *prog);
  96
  97 int OSSL_HTTP_parse_url(const char *url, char **phost, char **pport,
  98                         int *pport_num, char **ppath, int *pssl);
  99
 100 # ifdef  __cplusplus
 101 }
 102 # endif
 103 #endif /* !defined(OPENSSL_HTTP_H) */