Module org.eclipse.jgit

Package org.eclipse.jgit.internal.submodule

Class SubmoduleValidator

java.lang.Object

org.eclipse.jgit.internal.submodule.SubmoduleValidator

public class SubmoduleValidator
extends Object

Validations for the git submodule fields (name, path, uri). Invalid values in these fields can cause security problems as reported in CVE-2018-11235 and CVE-2018-17456

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	SubmoduleValidator.SubmoduleValidationException	Error validating a git submodule declaration

Constructor Summary

Constructors

Constructor	Description
SubmoduleValidator()

Method Summary

Modifier and Type	Method	Description
static void	assertValidGitModulesFile(String gitModulesContents)	Validate a .gitmodules file
static void	assertValidSubmoduleName(String name)	Validate name for a submodule
static void	assertValidSubmodulePath(String path)	Validate path for a submodule
static void	assertValidSubmoduleUri(String uri)	Validate URI for a submodule

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SubmoduleValidator

public SubmoduleValidator()

Method Detail

assertValidSubmoduleName

public static void assertValidSubmoduleName(String name)
                                     throws SubmoduleValidator.SubmoduleValidationException

Validate name for a submodule

Parameters:

name - name of a submodule

Throws:

SubmoduleValidator.SubmoduleValidationException - name doesn't seem valid (detail in message)

assertValidSubmoduleUri

public static void assertValidSubmoduleUri(String uri)
                                    throws SubmoduleValidator.SubmoduleValidationException

Validate URI for a submodule

Parameters:

uri - uri of a submodule

Throws:

SubmoduleValidator.SubmoduleValidationException - uri doesn't seem valid

assertValidSubmodulePath

public static void assertValidSubmodulePath(String path)
                                     throws SubmoduleValidator.SubmoduleValidationException

Validate path for a submodule

Parameters:

path - path of a submodule

Throws:

SubmoduleValidator.SubmoduleValidationException - path doesn't look right

assertValidGitModulesFile

public static void assertValidGitModulesFile(String gitModulesContents)
                                      throws SubmoduleValidator.SubmoduleValidationException

Validate a .gitmodules file

Parameters:

gitModulesContents - Contents of a .gitmodule file. They will be parsed internally.

Throws:

SubmoduleValidator.SubmoduleValidationException - if the contents don't look like a configuration file or field values are not valid