AttributionSource Classe

Definição

[Android.Runtime.Register("android/content/AttributionSource", ApiSince=31, DoNotGenerateAcw=true)]
public sealed class AttributionSource : Java.Lang.Object, Android.OS.IParcelable, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("android/content/AttributionSource", ApiSince=31, DoNotGenerateAcw=true)>]
type AttributionSource = class
    inherit Object
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Herança

Object

Object

AttributionSource

Atributos

RegisterAttribute

Implementações

IParcelable IJavaObject IJavaPeerable IDisposable

Comentários

Essa classe representa uma fonte à qual o acesso aos dados protegidos por permissão deve ser atribuído. As fontes de atribuição podem ser encadeadas para representar casos em que os dados protegidos fluiriam por vários aplicativos. Por exemplo, o aplicativo A pode solicitar contatos ao aplicativo B e, por sua vez, o aplicativo B pode solicitar contatos ao aplicativo C. Nesse caso, a cadeia de atribuição seria A -> B -> C e o fluxo de dados seria C -> B -> A. Há dois benefícios principais de usar o mecanismo de origem de atribuição: evite fazer verificações de permissão explícitas em nome do aplicativo de chamada se você estiver acessando dados privados em seu nome para enviar de volta; evite o acesso duplo a dados culpando o que acontece quando você verifica as permissões do aplicativo de chamada e quando você acessa os dados por trás dessas permissões (para permissões de runtime). Além disso, se não estiver culpando explicitamente o chamador, o acesso a dados será contado para seu aplicativo versus para o aplicativo anterior em que o seu era apenas um proxy.

Cada Context um tem uma fonte de atribuição e você pode obtê-la por meio Context#getAttributionSource() da própria representação, que é uma cadeia de uma. Você pode atribuir trabalho a outro aplicativo ou, mais precisamente, a uma cadeia de aplicativos, por meio da qual os dados que você estaria acessando fluiriam, Context#createContext( ContextParams) além de especificar uma fonte de atribuição para o próximo aplicativo receber os dados protegidos que você está acessando.AttributionSource.Builder#setNext( AttributionSource) A criação dessa cadeia de atribuição garante que a fonte de dados verifique se cada aplicativo na cadeia de atribuição tem permissão para acessar os dados antes de liberá-los. A fonte de dados também registrará adequadamente que esses dados foram acessados pelos aplicativos na sequência se os dados estiverem por trás de uma permissão confidencial (por exemplo, perigoso). Novamente, isso será útil se você estiver acessando os dados em nome de outro aplicativo, por exemplo, um reconhecedor de fala usando o microfone para que ele possa fornecer reconhecimento a um aplicativo de chamada.

Você pode criar uma cadeia de atribuição de você e de qualquer outro aplicativo sem qualquer verificação, pois isso já está disponível por meio das android.app.AppOpsManager APIs. Isso tem suporte para lidar com casos em que você não tem acesso à origem de atribuição do chamador e pode usar diretamente as AttributionSource.Builder APIs. No entanto, se os dados fluem por mais de dois aplicativos (mais do que você acessa os dados do chamador), você precisará ter um identificador para o AttributionSource contexto do aplicativo de chamada para criar um contexto de atribuição. Isso significa que você precisa ter uma API para que o outro aplicativo envie sua origem de atribuição ou use uma API de plataforma que redirecione a origem da atribuição de chamadores.

Você não pode forjar uma cadeia de atribuição sem a participação de cada aplicativo na cadeia de atribuição (além do caso especial mencionado acima). Para criar uma fonte de atribuição confiável, você precisa criar um contexto de atribuição que aponte para uma fonte de atribuição que foi explicitamente criada pelo aplicativo ao qual se refere, recursivamente.

Como a criação de um contexto de atribuição leva a todas as permissões para aplicativos na cadeia de atribuição que está sendo verificada, você precisa esperar obter uma exceção de segurança ao acessar APIs protegidas por permissão, já que algum aplicativo na cadeia pode não ter a permissão.

Java documentação para android.content.AttributionSource.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.