PASSWORD sprava - monetplus/IDport GitHub Wiki

Správa metody PASSWORD a jejích instancí

Metoda PASSWORD je jednoinstanční, tedy může mít pouze jednu aktivní instanci. Při aktivaci nové instance se stávající aktivní instance deaktivuje, instance v jiných stavech nejsou ovlivněny. Změny stavu metody jsou nezávislé na změnách stavů instancí a navzájem se neovlivňují. Pro aktivní použití metody PASSWORD je nutné mít v aktivním stavu zároveň metodu a instanci.

Blokace neúspěšnými pokusy o ověření transakce jsou prováděny na metodě, nelze zablokovat instanci nebo transakci. Konfiguračně lze nastavit:

  • počet pokusů o neplatné ověření transakce
  • doba dočasné blokace metody
  • počet opakování dočasné blokace před blokací trvalou
  • zda transakci po zablokování zneplatnit

Stavový diagram metody PASSWORD

Použité globální parametry:

Parametr Popis Hodnota/<Příklad>
.tenant označení organizace <Monet+>
.muid identifikátor uživatele
.methodType typ metody "PASSWORD"

Získání informací o metodě

  • vrací objekt s informacemi o metodě, jejích instancích a čítači neplatných pokusů
  • specifické parametry:
    • IN: .methodTypes - pole metod, pro které jsou žádány detailní informace
    • OUT: .data.methodInfo[].methodType = PASSWORD - typ metody
    • OUT: .data.methodInfoi[].state - stav metody
    • OUT: .data.methodInfo[].activeInstances - počet instancí v aktivním stavu
    • OUT: .data.methodInfo[].instances[].instanceId - identifikátor instance
    • OUT: .data.methodInfo[].instances[].state - stav instance
    • OUT: .data.methodInfo[].instances[].instanceName - explicitně nastavené pojmenování instance (IAPI/setInstanceName)
    • OUT: .data.methodInfo[].failedAttempts - počet neúspěšných pokusů o potvrzení transakce
    • OUT: .data.methodInfo[].remainingAttempts - počet zbývajících pokusů pro potvrzení transakce
    • OUT: .data.methodInfo[].blockedUntil - čas uvolnění dočasné blokace metody
  • volání endpointu:

IAPI/methodInfo

IN:	.tenant, .muid
	.methodTypes
OUT:	.data.methodInfo

Získání soli a typu algoritmu

  • získání soli a typu algoritmu pro výpočet hashe hesla a potvrzovacího kódu
  • volání endpointu:

IAPI/methodParams

IN:     .tenant, .muid, .methodType
OUT:    .data.methodSpecific.salt
	.data.methodSpecific.algType

Nastavení jména instance

  • specifické parametry:
    • IN: .instanceId - identifikátor instance (získaný z IAPI/initiateInstance nebo IAPI/methodInfo)
    • IN: .name - pojmenování instance (je-li prázdné, dosud použité pojmenování se zruší)
  • volání endpointu:

IAPI/setInstanceName

IN:	.tenant, .muid, .methodType
	.instanceId, .name

Manuální zablokování metody

  • volání endpointu:

IAPI/blockMethod

IN:	.tenant, .muid, .methodType

Manuální odblokování metody

  • volání endpointu:

IAPI/unblockMethod

IN:	.tenant, .muid, .methodType

Deaktivace metody

  • volání endpointu:

IAPI/deactivateMethod

IN:	.tenant, .muid, .methodType

Manuální zablokování instance

  • specifické parametry:
    • IN: .instanceId - identifikátor instance (získaný z IAPI/initiateInstance nebo IAPI/methodInfo)
  • volání endpointu:

IAPI/blockInstance

IN:	.tenant, .muid, .methodType
	.instanceId

Manuální odblokování instance

  • specifické parametry:
    • IN: .instanceId - identifikátor instance (získaný z IAPI/initiateInstance nebo IAPI/methodInfo)
  • volání endpointu:

IAPI/unblockInstance

IN:	.tenant, .muid, .methodType
	.instanceId

Deaktivace instance

  • specifické parametry:
    • IN: .instanceId - identifikátor instance (získaný z IAPI/initiateInstance nebo IAPI/methodInfo)
  • volání endpointu:

IAPI/deactivateInstance

IN:	.tenant, .muid, .methodType
	.instanceId
⚠️ **GitHub.com Fallback** ⚠️