Nextcloud PHP API (master)

IIncomingSignedRequest extends ISignedRequest

model wrapping an actual incoming request, adding details about the signature and the authenticity of the origin of the request.

This interface must not be implemented in your application but instead obtained from ISignatureManager::getIncomingSignedRequest.

$signedRequest = $this->signatureManager->getIncomingSignedRequest($mySignatoryManager);
Tags
see
ISignatureManager

for details on signature

since
33.0.0
Attributes
#[Consumable]
$since: '33.0.0'

Table of Contents

Methods

getBody()  : string
payload of the request
getDigest()  : string
checksum of the payload of the request
getDigestAlgorithm()  : DigestAlgorithm
get algorithm used to generate digest
getKeyId()  : string
returns the keyId extracted from the signature headers.
getOrigin()  : string
get the hostname at the source of the base request.
getRequest()  : IRequest
returns the base IRequest
getSignatory()  : Signatory
get the signatory, containing keys and details, related to this request
getSignature()  : string
get the signed version of the signature
getSignatureData()  : array<string|int, mixed>
returns data used to generate signature
getSigningElement()  : string
getSigningElements()  : array<string|int, mixed>
get the list of elements in the Signature header of the request
hasSignatory()  : bool
returns if a signatory related to this request have been found and defined
setSignatory()  : self
set the signatory, containing keys and details, related to this request
setSigningElements()  : self
set the list of headers related to the signature of the request
verify()  : void
confirm the current signed request's identity is correct

Methods

getBody()

payload of the request

public getBody() : string
Tags
since
33.0.0
Return values
string

getDigest()

checksum of the payload of the request

public getDigest() : string
Tags
since
33.0.0
Return values
string

getOrigin()

get the hostname at the source of the base request.

public getOrigin() : string

based on the keyId defined in the signature header.

Tags
since
33.0.0
Return values
string

getSignature()

get the signed version of the signature

public getSignature() : string
Tags
since
33.0.0
Return values
string

getSignatureData()

returns data used to generate signature

public getSignatureData() : array<string|int, mixed>
Tags
since
33.0.0
Return values
array<string|int, mixed>

getSigningElements()

get the list of elements in the Signature header of the request

public getSigningElements() : array<string|int, mixed>
Tags
since
33.0.0
Return values
array<string|int, mixed>

hasSignatory()

returns if a signatory related to this request have been found and defined

public hasSignatory() : bool
Tags
since
33.0.0
Return values
bool

setSignatory()

set the signatory, containing keys and details, related to this request

public setSignatory(Signatory $signatory) : self
Parameters
$signatory : Signatory
Tags
since
33.0.0
Return values
self

setSigningElements()

set the list of headers related to the signature of the request

public setSigningElements(array<string|int, mixed> $elements) : self
Parameters
$elements : array<string|int, mixed>
Tags
since
33.0.0
Return values
self

        
On this page

Search results