Modifier and Type	Class and Description
private static class	PushCertificateParser.PacketLineReader
private static class	PushCertificateParser.StreamReader
private static interface	PushCertificateParser.StringReader

Field Summary

Modifier and Type	Field and Description
pack-priv static final String	BEGIN_SIGNATURE
private final List<ReceiveCommand>	commands
private final Repository	db Database we write the push certificate into.
private final boolean	enabled
pack-priv static final String	END_CERT
pack-priv static final String	END_SIGNATURE
pack-priv static final String	NONCE
private final NonceGenerator	nonceGenerator
private final int	nonceSlopLimit The maximum time difference which is acceptable between advertised nonce and received signed nonce.
private PushCertificate.NonceStatus	nonceStatus
pack-priv static final String	PUSHEE
private String	pushee
pack-priv static final String	PUSHER
private PushCertificateIdent	pusher
private boolean	received
private String	receivedNonce The nonce the pusher signed.
private String	sentNonce The nonce that was sent to the client.
private String	signature
pack-priv static final String	VERSION
private String	version
private static final String	VERSION_0_1

Constructor Summary

Access	Constructor and Description
public	PushCertificateParser(Repository destination repository for the push. into, SignedPushConfig configuration for signed push. cfg) Constructor for PushCertificateParser.
private	PushCertificateParser()

Method Summary

Modifier and Type	Method and Description
public void	addCommand(ReceiveCommand the command. cmd) Add a command to the signature.
public void	addCommand(String the line read from the wire that produced this command, with optional trailing newline already trimmed. line) Add a command to the signature.
public PushCertificate	Returns: the parsed certificate, or null if push certificates are disabled. build() Build the parsed certificate
public boolean	Returns: if the repository is configured to use signed pushes in this context. enabled() Whether the repository is configured to use signed pushes in this context.
public static PushCertificate	Returns: the parsed certificate, or null if the reader was at EOF. fromReader(Reader input reader; consumed only up until the end of the next signature in the input. r) Parse a push certificate from a reader.
public static PushCertificate	Returns: the parsed certificate. fromString(String input string. str) Parse a push certificate from a string.
public String	Returns: the whole string for the nonce to be included into the capability advertisement, or null if push certificates are disabled. getAdvertiseNonce() Get the whole string for the nonce to be included into the capability advertisement
public PushCertificate	Returns: the parsed certificate, or null if the reader was at EOF. parse(Reader input reader; consumed only up until the end of the next signature in the input. r) Parse a push certificate from a reader.
private static String	parseHeader(PushCertificateParser.StringReader reader, String header)
private static String	parseHeader(String s, String header)
public void	receiveHeader(PacketLineIn where we take the push certificate header from. pckIn, boolean affects nonce verification. When `stateless = true` the `NonceGenerator` will allow for some time skew caused by clients disconnected and reconnecting in the stateless smart HTTP protocol. stateless) Receive a list of commands from the input encapsulated in a push certificate.
private void	receiveHeader(PushCertificateParser.StringReader reader, boolean stateless)
public void	receiveSignature(PacketLineIn where we read the signature from. pckIn) Read the PGP signature.
private void	receiveSignature(PushCertificateParser.StringReader reader)
private String	sentNonce()

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

BEGIN_SIGNATURE	back to summary
pack-priv static final String BEGIN_SIGNATURE

commands	back to summary
private final List<ReceiveCommand> commands

db	back to summary
private final Repository db Database we write the push certificate into.

enabled	back to summary
private final boolean enabled

END_CERT	back to summary
pack-priv static final String END_CERT

END_SIGNATURE	back to summary
pack-priv static final String END_SIGNATURE

NONCE	back to summary
pack-priv static final String NONCE

nonceGenerator	back to summary
private final NonceGenerator nonceGenerator

nonceSlopLimit	back to summary
private final int nonceSlopLimit The maximum time difference which is acceptable between advertised nonce and received signed nonce.

nonceStatus	back to summary
private PushCertificate.NonceStatus nonceStatus

PUSHEE	back to summary
pack-priv static final String PUSHEE

pushee	back to summary
private String pushee

PUSHER	back to summary
pack-priv static final String PUSHER

pusher	back to summary
private PushCertificateIdent pusher

received	back to summary
private boolean received

receivedNonce back to summary

receivedNonce	back to summary
private String receivedNonce The nonce the pusher signed. This may vary from `sentNonce`; see git-core documentation for reasons.

private String receivedNonce

The nonce the pusher signed.

This may vary from sentNonce; see git-core documentation for reasons.

sentNonce	back to summary
private String sentNonce The nonce that was sent to the client.

signature	back to summary
private String signature

VERSION	back to summary
pack-priv static final String VERSION

version	back to summary
private String version

VERSION_0_1	back to summary
private static final String VERSION_0_1

Constructor Detail

PushCertificateParser	back to summary
public PushCertificateParser(Repository into, SignedPushConfig cfg) Constructor for PushCertificateParser. Parameters into:Repository destination repository for the push. cfg:SignedPushConfig configuration for signed push. Since 4.1

PushCertificateParser

back to summary

public PushCertificateParser(Repository into, SignedPushConfig cfg)

Constructor for PushCertificateParser.

Parameters

into:Repository: destination repository for the push.
cfg:SignedPushConfig: configuration for signed push.

Since

4.1

PushCertificateParser	back to summary
private PushCertificateParser()

Method Detail

addCommand	back to summary
public void addCommand(ReceiveCommand cmd) Add a command to the signature. Parameters cmd:ReceiveCommand the command. Since 4.1

addCommand

back to summary

public void addCommand(ReceiveCommand cmd)

Add a command to the signature.

Parameters

cmd:ReceiveCommand: the command.

Since

4.1

addCommand	back to summary
public void addCommand(String line) throws PackProtocolException Add a command to the signature. Parameters line:String the line read from the wire that produced this command, with optional trailing newline already trimmed. Exceptions PackProtocolException: if the raw line cannot be parsed to a command. Since 4.0

addCommand

back to summary

public void addCommand(String line) throws PackProtocolException

Add a command to the signature.

Parameters

line:String: the line read from the wire that produced this command, with optional trailing newline already trimmed.

Exceptions

PackProtocolException:: if the raw line cannot be parsed to a command.

Since

4.0

build	back to summary
public PushCertificate build() throws IOException Build the parsed certificate Returns:PushCertificate the parsed certificate, or null if push certificates are disabled. Exceptions IOException: if the push certificate has missing or invalid fields. Since 4.1

build

back to summary

public PushCertificate build() throws IOException

Build the parsed certificate

Returns:PushCertificate

the parsed certificate, or null if push certificates are disabled.

Exceptions

IOException:: if the push certificate has missing or invalid fields.

Since

4.1

enabled	back to summary
public boolean enabled() Whether the repository is configured to use signed pushes in this context. Returns:boolean if the repository is configured to use signed pushes in this context. Since 4.0

enabled

back to summary

public boolean enabled()

Whether the repository is configured to use signed pushes in this context.

Returns:boolean: if the repository is configured to use signed pushes in this context.
Since: 4.0

fromReader back to summary

fromReader	back to summary
public static PushCertificate fromReader(Reader r) throws PackProtocolException, IOException Parse a push certificate from a reader. Differences from the `org.eclipse.jgit.transport.PacketLineIn` receiver methods: Does not use pkt-line framing. Reads an entire cert in one call rather than depending on a loop in the caller. Does not assume a `"push-cert-end"` line. Parameters r:Reader input reader; consumed only up until the end of the next signature in the input. Returns:PushCertificate the parsed certificate, or null if the reader was at EOF. Exceptions PackProtocolException: if the certificate is malformed. IOException: if there was an error reading from the input. Since 4.1

public static PushCertificate fromReader(Reader r) throws PackProtocolException, IOException

Parse a push certificate from a reader.

Differences from the org.eclipse.jgit.transport.PacketLineIn receiver methods:

Does not use pkt-line framing.
Reads an entire cert in one call rather than depending on a loop in the caller.
Does not assume a "push-cert-end" line.

Parameters

r:Reader: input reader; consumed only up until the end of the next signature in the input.

Returns:PushCertificate

the parsed certificate, or null if the reader was at EOF.

Exceptions

PackProtocolException:: if the certificate is malformed.
IOException:: if there was an error reading from the input.

Since

4.1

fromString back to summary

fromString	back to summary
public static PushCertificate fromString(String str) throws PackProtocolException, IOException Parse a push certificate from a string. Parameters str:String input string. Returns:PushCertificate the parsed certificate. Exceptions PackProtocolException: if the certificate is malformed. IOException: if there was an error reading from the input. Since 4.1 See Also `fromReader(Reader)`

public static PushCertificate fromString(String str) throws PackProtocolException, IOException

Parse a push certificate from a string.

Parameters

str:String: input string.

Returns:PushCertificate

the parsed certificate.

Exceptions

PackProtocolException:: if the certificate is malformed.
IOException:: if there was an error reading from the input.

Since

4.1

See Also

fromReader(Reader)

getAdvertiseNonce	back to summary
public String getAdvertiseNonce() Get the whole string for the nonce to be included into the capability advertisement Returns:String the whole string for the nonce to be included into the capability advertisement, or null if push certificates are disabled. Since 4.0

getAdvertiseNonce

back to summary

public String getAdvertiseNonce()

Get the whole string for the nonce to be included into the capability advertisement

Returns:String: the whole string for the nonce to be included into the capability advertisement, or null if push certificates are disabled.
Since: 4.0

parse back to summary

parse	back to summary
public PushCertificate parse(Reader r) throws PackProtocolException, IOException Parse a push certificate from a reader. Parameters r:Reader input reader; consumed only up until the end of the next signature in the input. Returns:PushCertificate the parsed certificate, or null if the reader was at EOF. Exceptions PackProtocolException: if the certificate is malformed. IOException: if there was an error reading from the input. Since 4.1 See Also `fromReader(Reader)`

public PushCertificate parse(Reader r) throws PackProtocolException, IOException

Parse a push certificate from a reader.

Parameters

r:Reader: input reader; consumed only up until the end of the next signature in the input.

Returns:PushCertificate

the parsed certificate, or null if the reader was at EOF.

Exceptions

PackProtocolException:: if the certificate is malformed.
IOException:: if there was an error reading from the input.

Since

4.1

See Also

fromReader(Reader)

parseHeader	back to summary
private static String parseHeader(PushCertificateParser.StringReader reader, String header) throws IOException

parseHeader	back to summary
private static String parseHeader(String s, String header) throws IOException

receiveHeader back to summary

receiveHeader	back to summary
public void receiveHeader(PacketLineIn pckIn, boolean stateless) throws IOException Receive a list of commands from the input encapsulated in a push certificate. This method doesn't parse the first line `"push-cert \NUL <capabilities>"`, but assumes the first line including the capabilities has already been handled by the caller. Parameters pckIn:PacketLineIn where we take the push certificate header from. stateless:boolean affects nonce verification. When `stateless = true` the `NonceGenerator` will allow for some time skew caused by clients disconnected and reconnecting in the stateless smart HTTP protocol. Exceptions IOException: if the certificate from the client is badly malformed or the client disconnects before sending the entire certificate. Since 4.0

public void receiveHeader(PacketLineIn pckIn, boolean stateless) throws IOException

Receive a list of commands from the input encapsulated in a push certificate.

This method doesn't parse the first line "push-cert \NUL <capabilities>", but assumes the first line including the capabilities has already been handled by the caller.

Parameters

pckIn:PacketLineIn: where we take the push certificate header from.
stateless:boolean: affects nonce verification. When stateless = true the NonceGenerator will allow for some time skew caused by clients disconnected and reconnecting in the stateless smart HTTP protocol.

Exceptions

IOException:: if the certificate from the client is badly malformed or the client disconnects before sending the entire certificate.

Since

4.0

receiveHeader	back to summary
private void receiveHeader(PushCertificateParser.StringReader reader, boolean stateless) throws IOException

receiveSignature back to summary

receiveSignature	back to summary
public void receiveSignature(PacketLineIn pckIn) throws IOException Read the PGP signature. This method assumes the line `"-----BEGIN PGP SIGNATURE-----"` has already been parsed, and continues parsing until an `"-----END PGP SIGNATURE-----"` is found, followed by `"push-cert-end"`. Parameters pckIn:PacketLineIn where we read the signature from. Exceptions IOException: if the signature is invalid. Since 4.0

public void receiveSignature(PacketLineIn pckIn) throws IOException

Read the PGP signature.

This method assumes the line "-----BEGIN PGP SIGNATURE-----" has already been parsed, and continues parsing until an "-----END PGP SIGNATURE-----" is found, followed by "push-cert-end".

Parameters

pckIn:PacketLineIn: where we read the signature from.

Exceptions

IOException:: if the signature is invalid.

Since

4.0

receiveSignature	back to summary
private void receiveSignature(PushCertificateParser.StringReader reader) throws IOException

sentNonce	back to summary
private String sentNonce()

org.eclipse.jgit.transport back to summary

private Class PushCertificateParser.PacketLineReader

Class Inheritance

extends Object
implements StringReader

java.lang.Object
org.eclipse.jgit.transport.PushCertificateParser.PacketLineReader

All Implemented Interfaces

org.eclipse.jgit.transport.PushCertificateParser.StringReader

Field Summary

Modifier and Type	Field and Description
private final PacketLineIn	pckIn

Constructor Summary

Access	Constructor and Description
private	PacketLineReader(PacketLineIn pckIn)

Method Summary

Modifier and Type	Method and Description
public String	read() Implements org.eclipse.jgit.transport.PushCertificateParser.StringReader.read.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

pckIn	back to summary
private final PacketLineIn pckIn

Constructor Detail

PacketLineReader	back to summary
private PacketLineReader(PacketLineIn pckIn)

Method Detail

read	back to summary
public String read() throws IOException Implements org.eclipse.jgit.transport.PushCertificateParser.StringReader.read. Returns:String Doc from org.eclipse.jgit.transport.PushCertificateParser.StringReader.read. the next string from the input, up to an optional newline, with newline stripped if present Annotations @Override Exceptions IOException: Doc from org.eclipse.jgit.transport.PushCertificateParser.StringReader.read. if an error occurred during reading.

read

back to summary

public String read() throws IOException

Implements org.eclipse.jgit.transport.PushCertificateParser.StringReader.read.

Returns:String

Doc from org.eclipse.jgit.transport.PushCertificateParser.StringReader.read.

the next string from the input, up to an optional newline, with newline stripped if present

Annotations