This method should only be called once, before the connection is used.
(
self,
key_file: str | None = None,
cert_file: str | None = None,
cert_reqs: int | str | None = None,
key_password: str | None = None,
ca_certs: str | None = None,
assert_hostname: None | str | typing.Literal[False] = None,
assert_fingerprint: str | None = None,
ca_cert_dir: str | None = None,
ca_cert_data: None | str | bytes = None,
)
| 681 | self._connect_callback = None |
| 682 | |
| 683 | def set_cert( |
| 684 | self, |
| 685 | key_file: str | None = None, |
| 686 | cert_file: str | None = None, |
| 687 | cert_reqs: int | str | None = None, |
| 688 | key_password: str | None = None, |
| 689 | ca_certs: str | None = None, |
| 690 | assert_hostname: None | str | typing.Literal[False] = None, |
| 691 | assert_fingerprint: str | None = None, |
| 692 | ca_cert_dir: str | None = None, |
| 693 | ca_cert_data: None | str | bytes = None, |
| 694 | ) -> None: |
| 695 | """ |
| 696 | This method should only be called once, before the connection is used. |
| 697 | """ |
| 698 | warnings.warn( |
| 699 | "HTTPSConnection.set_cert() is deprecated and will be removed " |
| 700 | "in urllib3 v3.0. Instead provide the parameters to the " |
| 701 | "HTTPSConnection constructor.", |
| 702 | category=FutureWarning, |
| 703 | stacklevel=2, |
| 704 | ) |
| 705 | |
| 706 | # If cert_reqs is not provided we'll assume CERT_REQUIRED unless we also |
| 707 | # have an SSLContext object in which case we'll use its verify_mode. |
| 708 | if cert_reqs is None: |
| 709 | if self.ssl_context is not None: |
| 710 | cert_reqs = self.ssl_context.verify_mode |
| 711 | else: |
| 712 | cert_reqs = resolve_cert_reqs(None) |
| 713 | |
| 714 | self.key_file = key_file |
| 715 | self.cert_file = cert_file |
| 716 | self.cert_reqs = cert_reqs |
| 717 | self.key_password = key_password |
| 718 | self.assert_hostname = assert_hostname |
| 719 | self.assert_fingerprint = assert_fingerprint |
| 720 | self.ca_certs = ca_certs and os.path.expanduser(ca_certs) |
| 721 | self.ca_cert_dir = ca_cert_dir and os.path.expanduser(ca_cert_dir) |
| 722 | self.ca_cert_data = ca_cert_data |
| 723 | |
| 724 | def connect(self) -> None: |
| 725 | # Today we don't need to be doing this step before the /actual/ socket |