Класс PrivateCredentialPermission

java.lang.Object

java.security.Permission

javax.security.auth.PrivateCredentialPermission

Все реализуемые интерфейсы:: Serializable, Guard

public final class PrivateCredentialPermission extends Permission

Этот класс используется для защиты доступа к приватным Credentials, принадлежащим конкретному Subject. Subject представлен набором Principals.

Имя целевого объекта этого Permission указывает имя класса Credential и набор Principals. Единственное допустимое значение для действий этого разрешения — "read". Имя целевого объекта должно соответствовать следующему синтаксису:

      CredentialClass {PrincipalClass "PrincipalName"}*

Например, следующее разрешение предоставляет доступ к com.sun.PrivateCredential, которому принадлежат субъекты, имеющие com.sun.Principal с именем "duke". Обратите внимание, что, хотя в этом примере, а также во всех примерах ниже, информация о Codebase, SignedBy или Principal в утверждении о предоставлении отсутствует (для простоты), в реальных конфигурациях политики должна быть указана эта информация, если это необходимо.


    grant {
      permission javax.security.auth.PrivateCredentialPermission
              "com.sun.PrivateCredential com.sun.Principal \"duke\"",
              "read";
    };

Если CredentialClass равен "*", то доступ предоставляется ко всем приватным Credentials, принадлежащим указанному Subject. Если "PrincipalName" равен "*", то доступ предоставляется к указанному Credential, которому принадлежат любые Subject, имеющие указанный Principal (фактическое имя Principal не имеет значения). Например, следующее разрешение предоставляет доступ к a.b.Credential, которому принадлежат любые Subject с a.b.Principal.

    grant {
      permission javax.security.auth.PrivateCredentialPermission
              "a.b.Credential a.b.Principal "*"",
              "read";
    };

Если и PrincipalClass, и "PrincipalName" равны "*", то доступ предоставляется к указанному Credential, которому принадлежат любые Subject.

Кроме того, пара PrincipalClass/PrincipalName может повторяться:

    grant {
      permission javax.security.auth.PrivateCredentialPermission
              "a.b.Credential a.b.Principal "duke" c.d.Principal "dukette"",
              "read";
    };

Вышеприведенное разрешение предоставляет доступ к приватному Credential "a.b.Credential", принадлежащему Subject с по меньшей мере двумя связанными Principals: "a.b.Principal" с именем "duke" и "c.d.Principal" с именем "dukette".

С тех пор:

1.4

См. также:

Сериализованная форма

Краткое описание конструкторов

Конструктор	Описание
`PrivateCredentialPermission(String name, String actions)`	Создает новый `PrivateCredentialPermission` со специфицированным `name`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object obj)`	Проверяет два объекта `PrivateCredentialPermission` на равенство.
`String`	`getActions()`	Возвращает "каноническое строковое представление" действий.
`String`	`getCredentialClass()`	Возвращает имя класса Credential, связанного с этим `PrivateCredentialPermission`.
`String[][]`	`getPrincipals()`	Возвращает классы и имена `Principal` , связанные с этим `PrivateCredentialPermission`.
`int`	`hashCode()`	Возвращает значение хэш-кода для этого объекта.
`boolean`	`implies(Permission p)`	Проверяет, подразумевает ли это `PrivateCredentialPermission` указанное `Permission`.
`PermissionCollection`	`newPermissionCollection()`	Возвращает гомогенную коллекцию PrivateCredentialPermissions в `PermissionCollection`.

Методы, объявленные в классе java.security.Permission

checkGuard, getName, toString

Методы, объявленные в классе java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Подробное описание конструкторов

PrivateCredentialPermission

public PrivateCredentialPermission(String name, String actions)

Создает новый PrivateCredentialPermission со специфицированным name. name указывает как класс Credential, так и Principal набор.

Параметры:: name - имя, указывающее класс Credential и Principal набор.; actions - действия, указывающие, что Credential может быть прочитан.
Исключения:: IllegalArgumentException - если name не соответствует правильному синтаксису или если actions не равно "read".

Подробное описание методов

getCredentialClass

public String getCredentialClass()

Возвращает имя класса Credential, связанного с этим PrivateCredentialPermission.

Возвращает:: имя класса Credential, связанного с этим PrivateCredentialPermission.

getPrincipals

public String[][] getPrincipals()

Возвращает классы и имена Principal , связанные с этим PrivateCredentialPermission . Информация возвращается в виде двумерного массива (массив[x][y]). Значение 'x' соответствует количеству пар классов и имен Principal . Когда (y==0), оно соответствует классу Principal, а когда (y==1), оно соответствует имени Principal . Например, array[0][0] соответствует имени класса первого Principal в массиве. array[0][1] соответствует имени Principal первого Principal в массиве.

Возвращает:: классы и имена Principal , связанные с этим PrivateCredentialPermission.

implies

public boolean implies(Permission p)

Проверяет, подразумевает ли это PrivateCredentialPermission указанное Permission .

Этот метод возвращает true, если:

p является экземпляром PrivateCredentialPermission и

имя целевого объекта для p подразумевается именем целевого объекта этого объекта. Например:

  [* P1 "duke"] implies [a.b.Credential P1 "duke"].
  [C1 P1 "duke"] implies [C1 P1 "duke" P2 "dukette"].
  [C1 P2 "dukette"] implies [C1 P1 "duke" P2 "dukette"].

Указано в:: implies в классе Permission
Параметры:: p - проверяемое Permission.
Возвращает:: true, если это PrivateCredentialPermission подразумевает указанное Permission, false — если нет.

equals

public boolean equals(Object obj)

Проверяет два объекта PrivateCredentialPermission на равенство. Проверяет, что obj является PrivateCredentialPermission, имеет тот же класс credential, что и этот объект, а также те же Principals, что и этот объект. Порядок Principals в именах целевых объектов соответствующих разрешений не имеет значения.

Указано в:

equals в классе Permission

Параметры:

obj - объект, с которым мы проверяем равенство этому объекту.

Возвращает:

true, если obj является PrivateCredentialPermission, имеет тот же класс credential, что и этот объект, и имеет те же Principals, что и этот объект.

См. также:

hashCode

public int hashCode()

Возвращает значение хэш-кода для этого объекта.

Указано в:

hashCode в классе Permission

Возвращает:

значение хэш-кода для этого объекта.

См. также:

getActions

public String getActions()

Возвращает "каноническое строковое представление" действий. Этот метод всегда возвращает строку "read".

Указано в:: getActions в классе Permission
Возвращает:: действия (всегда возвращает "read").

newPermissionCollection

public PermissionCollection newPermissionCollection()

Возвращает гомогенную коллекцию PrivateCredentialPermissions в PermissionCollection. Такой PermissionCollection не определен, поэтому этот метод всегда возвращает null.

Переопределяет:: newPermissionCollection в классе Permission
Возвращает:: null во всех случаях.

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.base/javax/security/auth/PrivateCredentialPermission.html