Package org.jitsi.service.neomedia.event

Interface SrtpListener

  • public interface SrtpListener
    The SrtpListener is meant to be used by the media stream creator, as the name indicates in order to be notified when a security event has occurred that concerns a secure (media) transport i.e. SrtpControl such as ZRTP, SDES and DTLS-SRTP.
    Author:
    Yana Stamcheva

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static int ERROR
      This is an error message.
      static int INFORMATION
      This is a information message.
      static int SEVERE
      This is a severe error.
      static int WARNING
      This is a warning message.

    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      void securityMessageReceived​(String message, String i18nMessage, int severity)
      Indicates that a security message has occurred associated with a failure/warning or information coming from the encryption protocol/secure transport.
      void securityNegotiationStarted​(org.jitsi.utils.MediaType mediaType, SrtpControl sender)
      Indicates that we started the process of securing the connection.
      void securityTimeout​(org.jitsi.utils.MediaType mediaType)
      Indicates that the other party has timed out replying to our offer to secure the connection.
      void securityTurnedOff​(org.jitsi.utils.MediaType mediaType)
      Indicates that the security has been turned off.
      void securityTurnedOn​(org.jitsi.utils.MediaType mediaType, String cipher, SrtpControl sender)
      Indicates that the security has been turned on.

    • Field Detail

      • INFORMATION

        static final int INFORMATION
        This is a information message. Security will be established.
        See Also:
        Constant Field Values

      • WARNING

        static final int WARNING
        This is a warning message. Security will not be established.
        See Also:
        Constant Field Values

      • SEVERE

        static final int SEVERE
        This is a severe error. Security will not be established.
        See Also:
        Constant Field Values

      • ERROR

        static final int ERROR
        This is an error message. Security will not be established.
        See Also:
        Constant Field Values

    • Method Detail

      • securityTurnedOn

        void securityTurnedOn​(org.jitsi.utils.MediaType mediaType,
                      String cipher,
                      SrtpControl sender)
        Indicates that the security has been turned on. When we are in the case of using multistreams when the master stream ZRTP is initialized and established the param multiStreamData holds the data needed for the slave streams to establish their sessions. If this is a securityTurnedOn event on non master stream the multiStreamData is null.
        Parameters:
        mediaType - the MediaType of the call session
        cipher - the security cipher that encrypts the call
        sender - the control that initiated the event.

      • securityTurnedOff

        void securityTurnedOff​(org.jitsi.utils.MediaType mediaType)
        Indicates that the security has been turned off.
        Parameters:
        mediaType - the MediaType of the call session

      • securityMessageReceived

        void securityMessageReceived​(String message,
                             String i18nMessage,
                             int severity)
        Indicates that a security message has occurred associated with a failure/warning or information coming from the encryption protocol/secure transport.
        Parameters:
        message - the message.
        i18nMessage - the internationalized message
        severity - severity level

      • securityTimeout

        void securityTimeout​(org.jitsi.utils.MediaType mediaType)
        Indicates that the other party has timed out replying to our offer to secure the connection.
        Parameters:
        mediaType - the MediaType of the call session

      • securityNegotiationStarted

        void securityNegotiationStarted​(org.jitsi.utils.MediaType mediaType,
                                SrtpControl sender)
        Indicates that we started the process of securing the connection.
        Parameters:
        mediaType - the MediaType of the call session
        sender - the control that initiated the event.