SSL_GET0_PEER_SCTS(3ossl)

📦 version 3.5.0, in opensuse-leap 16.0

💅 SSL_GET0_PEER_SCTS 💅

okay so this is a page from the 3ossl manual — yes, the OpenSSL girlies — and it's all about a tiny function that hands you back your Signed Certificate Timestamps. no cap, it's short but it's iconic. let's get into it 🫶

✨ NAME ✨

SSL_get0_peer_scts — literally just "get the SCTs you received," that's the whole vibe 🎀

🌸 SYNOPSIS 🌸

#include <openssl/ssl.h>

const STACK_OF(SCT) *SSL_get0_peer_scts(SSL *s);

🦋 DESCRIPTION 🦋

okay so SSL_get0_peer_scts() returns the signed certificate timestamps (SCTs) that have been received. that's it, that's the function 💖

but here's the little detail that matters: the first time you call this for a given SSL instance, it actually goes digging — it will examine the TLS extensions, the OCSP response, and the peer's certificate looking for SCTs 👀. every call after that? it just gives you back the same SCTs. cached and cozy, no re-scanning. slay.

🔥 RESTRICTIONS 🔥

real talk though, there's a catch, and you need to hear it 🙈

if no Certificate Transparency validation callback has been set — and that's via SSL_CTX_set_ct_validation_callback or SSL_set_ct_validation_callback — then this function is not guaranteed to return all of the SCTs that the peer is capable of sending. like, it might not give you the full set. so don't come for it if SCTs are missing. set your callback, bestie. 💅

👑 RETURN VALUES 👑

SSL_get0_peer_scts() returns a list of the SCTs it found — cute, useful, everything ✨ — or NULL if an error occurs 😭. that's the whole contract.

🌈 SEE ALSO 🌈

Copyright 2016 The OpenSSL Project Authors. All Rights Reserved.

Licensed under the Apache License 2.0 (the "License"). You may not use this file except in compliance with the License. You can obtain a copy in the file LICENSE in the source distribution or at <https://www.openssl.org/source/license.html>.

and that's the whole page, bestie 🧚 — this was 3.5.0, dated 2026-09-25, straight from the 3ossl manual. go forth and check those timestamps 💅⭐🍓

📦 where this page comes from